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5.3.1.5.2 Test area files 456 

5.3.1.5.3 Test coverage 457 

5.3.1.5.4 Test procedure 457 

5.3.1.6 Method select (short fid) 459 

5.3.1.6.1 Conformance requirement 459 

5.3.1.6.2 Test area files 460 

5.3.1.6.3 Test coverage 460 

5.3.1.6.4 Test procedure 461 

5.3.1.7 Method status 462 

5.3.1.7.1 Conformance requirement 462 

5.3.1.7.2 Test area files 463 

5.3.1.7.3 Test coverage 463 

5.3.1.7.4 Test procedure 463 

5.3.1.8 Method readBinary 464 

5.3.1.8.1 Conformance requirement 464 

5.3.1.8.2 Test area files 465 

5.3.1.8.3 Test coverage 465 

5.3.1.8.4 Test procedure 466 

5.3.1.9 Method updateBinary 467 

5.3.1.9.1 Conformance requirement 467 

5.3.1.9.2 Test area files 468 

5.3.1.9.3 Test coverage 468 

5.3.1.9.4 Test procedure 468 

5.3.1.10 Method readRecord 469 

5.3.1.10.1 Conformance requirement 469 

5.3.1.10.2 Test area files 471 

5.3.1.10.3 Test coverage 471 

5.3.1.10.4 Test procedure 472 

5.3.1.11 Method updateRecord 475 

5.3.1.11.1 Conformance requirement 475 
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5.3.1.11.2 Test area files 477 

5.3.1.11.3 Test coverage 477 

5.3.1.11.4 Test procedure 478 

5.3.1.12 Method searchRecord 482 

5.3.1.12.1 Conformance requirement 482 

5.3.1.12.2 Test area files 483 

5.3.1.12.3 Test coverage 484 

5.3.1.12.4 Test procedure 484 

5.3.1.13 Method increase 495 

5.3.1.13.1 Conformance requirement 495 

5.3.1.13.2 Testareafiles 496 

5.3.1.13.3 Test coverage 496 

5.3.1.13.4 Test procedure 496 

5.3.1.14 Method deactivateFile 499 

5.3.1.14.1 Conformance requirement 499 

5.3.1.14.2 Testareafiles 500 

5.3.1.14.3 Test coverage 500 

5.3.1.14.4 Test procedure 500 

5.3.1.15 Method activateFile 500 

5.3.1.15.1 Conformance requirement 500 

5.3.1.15.2 Testareafiles 501 

5.3.1.15.3 Test coverage 501 

5.3.1.15.4 Test procedure 501 

5.3.2 Class AdminFileViewBuilder 502 

5.3.2.1 Method getTheUlCCAdminPile View 502 

5.3.2.1.1 Conformance requirement 502 

5.3.2.1.2 Testareafiles 502 

5.3.2.1.3 Test coverage 503 

5.3.2.1.4 Test procedure 504 

5.3.2.2 Method getTheAdminFileView(javacard.framework.AID aid, byte event) 506 

5.3.2.2.1 Conformance requirement: 506 

5.3.2.2.2 Testareafiles 507 

5.3.2.2.3 Test coverage 507 

5.3.2.2.4 Test procedure 508 

5.3.2.3 Method getTheAdminFileView(byte[] buffer, short bOffset, short bLength, byte event) 510 

5.3.2.3.1 Conformance requirement: 510 

5.3.2.3.2 Test area files 511 

5.3.2.3.3 Test coverage 511 

5.3.2.3.4 Test procedure 512 

5.3.3 Class AdminException 516 

5.3.3.1 Constructor 516 

5.3.3.1.1 Conformance requirement 516 

5.3.3.1.2 Test area files 516 

5.3.3.1.3 Test coverage 516 

5.3.3.1.4 Test procedure 516 

5.3.3.2 Method throwit 517 

5.3.3.2.1 Conformance requirement 517 

5.3.3.2.2 Test area files 517 

5.3.3.2.3 Test coverage 517 

5.3.3.2.4 Test procedure 517 

5.3.3.3 Reason Codes 518 

5.3.3.3.1 Conformance Requirement: 518 

5.3.3.3.2 Testareafiles 518 

5.3.3.3.3 Test Coverage 518 

5.3.3.3.4 Test Procedure 518 

5.4 Package uicc. system 518 

5.4.1 Class HandlerBuilder 518 

5.4.1.1 Method buildTLVHandler(byte type, short capacity) 518 

5.4.1.1.1 Conformance requirement 518 

5.4.1.1.2 Testareafiles 519 

5.4.1.1.3 Test coverage 519 

5.4.1.1.4 Test procedure 519 
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Method buildTLVHandler(byte type, short capacity, byte[] buffer , short bOffset, short bLength) ...520 

Conformance requirement 520 

Test area files 520 

Test coverage 521 

Test procedure 521 

Interface UlCCPlatform 522 

Method getTheVolatileByte Array 522 

Conformance requirement 522 

Test area files 523 

Test coverage 523 

Test procedure 523 

CAT Runtime Environment 524 

Minimum Handler Availability 524 

ProactiveHandler 524 

Conformance requirement 524 

Test area files 525 

Test coverage 525 

Test procedure 526 

ProactiveResponseHandler 539 

Conformance requirement 539 

Test area files 541 

Test coverage 541 

Test procedure 541 

EnvelopeHandler 557 

Conformance requirement 557 

Test area files 559 

Test coverage 559 

Test procedure 560 

EnvelopeResponseHandler 566 

Conformance requirement 566 

Test area files 567 

Test coverage 567 

Test procedure 568 

Handler Integrity 583 

ProactiveHandler 583 

Conformance requirement 583 

Test area files 583 

Test coverage 583 

Test procedure 584 

ProactiveResponseHandler 585 

Conformance requirement 585 

Test area files 586 

Test coverage 586 

Test procedure 587 

EnvelopeHandler 588 

Conformance requirement 588 

Test area files 589 

Test coverage 589 

Test procedure 590 

EnvelopeResponseHandler 611 

Conformance requirement 611 

Test area files 612 

Test coverage 612 

Test procedure 612 

Applet Triggering 612 

General behaviour 612 

Conformance requirement 612 

Test area files 613 

Test coverage 613 

Test procedure 613 

EVENT_PROFILE_DOWNLOAD 613 

Conformance requirement 613 
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5.5.3.2.2 Test area files 614 

5.5.3.2.3 Test coverage 614 

5.5.3.2.4 Test procedure 614 

5.5.3.3 EVENT_MENU_SELECTION 615 

5.5.3.3.1 Conformance requirement 615 

5.5.3.3.2 Test area files 616 

5.5.3.3.3 Test coverage 616 

5.5.3.3.4 Test procedure 616 

5.5.3.4 EVENT_MENU_SELECTION_HELP_REQUEST 616 

5.5.3.4.1 Conformance requirement 617 

5.5.3.4.2 Test area files 617 

5.5.3.4.3 Test coverage 617 

5.5.3.4.4 Test procedure 618 

5.5.3.5 EVENT_CALL_CONTROL_BY_NAA 620 

5.5.3.5.1 Conformance requirement 620 

5.5.3.5.2 Test area files 620 

5.5.3.5.3 Test coverage 620 

5.5.3.5.4 Test procedure 620 

5.5.3.6 EVENT_TIMER_EXPIRATION 621 

5.5.3.6.1 Conformance requirement 621 

5.5.3.6.2 Test area files 621 

5.5.3.6.3 Test coverage 622 

5.5.3.6.4 Test procedure 622 

5.5.3.7 EVENT_EVENT_DOWNLOAD_MT_CALL 622 

5.5.3.7.1 Conformance requirement 622 

5.5.3.7.2 Test area files 623 

5.5.3.7.3 Test coverage 623 

5.5.3.7.4 Test procedure 623 

5.5.3.8 EVENT_EVENT_DOWNLOAD_CALL_CONNECTED 623 

5.5.3.8.1 Conformance requirement 623 

5.5.3.8.2 Test area files 624 

5.5.3.8.3 Test coverage 624 

5.5.3.8.4 Test procedure 624 

5.5.3.9 EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED 625 

5.5.3.9.1 Conformance requirement 625 

5.5.3.9.2 Test area files 625 

5.5.3.9.3 Test coverage 625 

5.5.3.9.4 Test procedure 625 

5.5.3.10 EVENT_EVENT_DOWNLOAD_LOCATION_STATUS 626 

5.5.3.10.1 Conformance requirement 626 

5.5.3.10.2 Test area files 626 

5.5.3.10.3 Test coverage 626 

5.5.3.10.4 Test procedure 627 

5.5.3.11 EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 627 

5.5.3.11.1 Conformance requirement 627 

5.5.3.11.2 Test area files 627 

5.5.3.11.3 Test coverage 628 

5.5.3.11.4 Test procedure 628 

5.5.3.12 EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE 628 

5.5.3.12.1 Conformance requirement 628 

5.5.3.12.2 Test area files 629 

5.5.3.12.3 Test coverage 629 

5.5.3.12.4 Test procedure 629 

5.5.3.13 EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS 630 

5.5.3.13.1 Conformance requirement 630 

5.5.3.13.2 Test area files 630 

5.5.3.13.3 Test coverage 630 

5.5.3.13.4 Test procedure 630 

5.5.3.14 EVENT_UNRECOGNIZED_ENVELOPE 631 

5.5.3.14.1 Conformance requirement 631 

5.5.3.14.2 Test area files 631 

5.5.3.14.3 Test coverage 631 
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5.5.3.14.4 Test procedure 632 

5.5.3.15 EVENT_STATUS_COMMAND 632 

5.5.3.15.1 Conformance requirement 632 

5.5.3.15.2 Test area files 632 

5.5.3.15.3 Test coverage 633 

5.5.3.15.4 Test procedure 633 

5.5.3.16 EVENT_EVENT_D0WNL0AD_LANGUAGE_SELECT10N 634 

5.5.3.16.1 Conformance requirement 634 

5.5.3.16.2 Test area files 635 

5.5.3.16.3 Test coverage 635 

5.5.3.16.4 Test procedure 635 

5.5.3.17 EVENT_EVENT_DOWNLOAD_BROWSER_TERMINATION 636 

5.5.3.17.1 Conformance requirement 636 

5.5.3.17.2 Test area files 636 

5.5.3.17.3 Test coverage 636 

5.5.3.17.4 Test procedure 636 

5.5.3.18 EVENT_FIRST_COMMAND_AFTER_ATR 637 

5.5.3.18.1 Conformance requirement 637 

5.5.3.18.2 Test area files 637 

5.5.3.18.3 Test coverage 638 

5.5.3.18.4 Test procedure 638 

5.5.3.19 EVENT_EVENT_D0WNL0AD_DATA_AVA1LABLE 639 

5.5.3.19.1 Conformance requirement 639 

5.5.3.19.2 Test area files 640 

5.5.3.19.3 Test coverage 640 

5.5.3.19.4 Test procedure 641 

5.5.3.20 EVENT_EVENT_DOWNLOAD_CHANNEL_STATUS 643 

5.5.3.20.1 Conformance requirement 643 

5.5.3.20.2 Test area files 643 

5.5.3.20.3 Test coverage 643 

5.5.3.20.4 Test procedure 644 

5.5.3.21 EVENT_EVENT_DOWNLOAD_ACCESS_TECHNOLOGY_CHANGE 646 

5.5.3.21.1 Conformance requirement 646 

5.5.3.21.2 Test area files 646 

5.5.3.21.3 Test coverage 646 

5.5.3.21.4 Test procedure 646 

5.5.3.22 EVENT_EVENT_DOWNLOAD_DlSPLAY_PARAMETERS_CHANGED 647 

5.5.3.22.1 Conformance requirement 647 

5.5.3.22.2 Test area files 647 

5.5.3.22.3 Test coverage 647 

5.5.3.22.4 Test procedure 648 

5.5.3.23 EVENT_EVENT_DOWNLOAD_LOCAL_CONNECTION 648 

5.5.3.23.1 Conformance requirement 648 

5.5.3.23.2 Test area files 649 

5.5.3.23.3 Test coverage 649 

5.5.3.23.4 Test procedure 649 

5.5.3.24 EVENT_APPL1CAT10N_DESELECT 651 

5.5.3.24.1 Conformance requirement 651 

5.5.3.24.2 Test area files 651 

5.5.3.24.3 Test coverage 651 

5.5.3.24.4 Test procedure 651 

5.5.3.25 EVENT_PROACTlVE_HANDLER_AVAlLABLE 652 

5.5.3.25.1 Conformance requirement 652 

5.5.3.25.2 Test area files 653 

5.5.3.25.3 Test coverage 653 

5.5.3.25.4 Test procedure 653 

5.5.3.26 EVENT_EVENT_DOWNLOAD_NETWORK_SEARCH_MODE_CHANGE 654 

5.5.3.26.1 Conformance requirement 654 

5.5.3.26.2 Test area files 655 

5.5.3.26.3 Test coverage 655 

5.5.3.26.4 Test procedure 655 

5.5.3.27 EVENT EVENT DOWNLOAD BROWSING STATUS 656 
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5.5.3.27.1 Conformance requirement 656 

5.5.3.27.2 Test area files 656 

5.5.3.27.3 Test coverage 656 

5.5.3.27.4 Test procedure 656 

5.5.3.28 EVENT_EXTERNAL_FILE_UPDATE 657 

5.5.3.28.1 Conformance requirement 657 

5.5.3.28.2 Test area files 657 

5.5.3.28.3 Test coverage 658 

5.5.3.28.4 Test procedure 658 

5.5.4 Proactive Command Sending by the CAT Runtime Environment 659 

5.5.4.1 System Proactive Commands 659 

5.5.4.1.1 Conformance requirement 659 

5.5.4.1.2 Test area files 660 

5.5.4.1.3 Test coverage 660 

5.5.4.1.4 Test procedure 661 

5.5.4.2 Interaction with GSM commands 665 

5.5.4.2.1 Conformance requirement 665 

5.5.4.2.2 Test area files 666 

5.5.4.2.3 Test coverage 666 

5.5.4.2.4 Test procedure 666 

5.5.4.3 Proactive Command Control 667 

5.5.4.3.1 Conformance requirement 667 

5.5.4.3.2 Test area files 668 

5.5.4.3.3 Test coverage 668 

5.5.4.3.4 Test procedure 668 

5.5.5 Exception Handling 670 

5.5.5.1 General Behaviour 670 

5.5.5.1.1 Conformance requirement 670 

5.5.5.1.2 Test area files 671 

5.5.5.1.3 Test coverage 671 

5.5.5.1.4 Test procedure 671 

5.5.5.2 Interaction with Multiple Triggering 672 

5.5.5.2.1 Conformance requirement 672 

5.5.5.2.2 Test area files 672 

5.5.5.2.3 Test coverage 672 

5.5.5.2.4 Test procedure 673 

5.5.6 Envelope Response Posting 673 

5.5.6.1 General Behaviour 673 

5.5.6.1.1 Conformance requirement 673 

5.5.6.1.2 Test area files 674 

5.5.6.1.3 Test coverage 674 

5.5.6.1.4 Test procedure 674 

5.5.6.2 EVENT_CALL_CONTROL_BY_NAA 674 

5.5.6.2.1 Conformance requirement 674 

5.5.6.2.2 Test area files 674 

5.5.6.2.3 Test coverage 674 

5.5.6.2.4 Test procedure 675 

5.5.6.3 EVENT_UNRECOGNlZED_ENVELOPE 675 

5.5.6.3.1 Conformance requirement 675 

5.5.6.3.2 Test area files 676 

5.5.6.3.3 Test coverage 676 

5.5.6.3.4 Test procedure 676 

5.5.7 Toolkit Installation 676 

5.5.7.1 General Behaviour 676 

5.5.7.1.1 Conformance requirement 676 

5.5.7.1.2 Test area files 677 

5.5.7.1.3 Test coverage 677 

5.5.7.1.4 Test procedure 677 

5.5.7.2 Timers Allocation 677 

5.5.7.2.1 Conformance requirement 677 

5.5.7.2.2 Test area files 678 

5.5.7.2.3 Test coverage 678 
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5.5.7.2.4 Test procedure 678 

5.5.7.3 Item Identifier 679 

5.5.7.3.1 Conformance requirement 679 

5.5.7.3.2 Test area files 679 

5.5.7.3.3 Test coverage 679 

5.5.7.3.4 Test procedure 680 

5.5.7.4 Item Position 681 

5.5.7.4.1 Conformance requirement 681 

5.5.7.4.2 Test area files 681 

5.5.7.4.3 Test coverage 682 

5.5.7.4.4 Test procedure 682 

5.5.7.5 Maximum Text Length for a menu entry 685 

5.5.7.5.1 Conformance requirement 685 

5.5.7.5.2 Test area files 686 

5.5.7.5.3 Test coverage 686 

5.5.7.5.4 Test procedure 686 

5.5.7.6 Maximum number of menu entries 687 

5.5.7.6.1 Conformance requirement 687 

5.5.7.6.2 Test area files 687 

5.5.7.6.3 Test coverage 687 

5.5.7.6.4 Test procedure 688 

5.5.7.7 Access Domain 688 

5.5.7.7.1 Conformance requirement 688 

5.5.7.7.2 Test area files 690 

5.5.7.7.3 Test coverage 690 

5.5.7.7.4 Test procedure 690 

5.5.7.8 Priority Level 699 

5.5.7.8.1 Conformance requirement 699 

5.5.7.8.2 Test area files 699 

5.5.7.8.3 Test coverage 699 

5.5.7.8.4 Test procedure 699 

5.5.7.9 Channel Allocation 702 

5.5.7.9.1 Conformance requirement 702 

5.5.7.9.2 Test area files 702 

5.5.7.9.3 Test coverage 703 

5.5.7.9.4 Test procedure 703 

5.5.7.10 Minimum Security Level 704 

5.5.7.10.1 Conformance requirement 704 

5.5.7.10.2 Test area files 704 

5.5.7.10.3 Test coverage 704 

5.5.7.10.4 Test procedure 704 

5.5.7.11 TAR Value(s) of the Toolkit Application instance 704 

5.5.7.11.1 Conformance requirement 704 

5.5.7.11.2 Test area files 705 

5.5.7.11.3 Test coverage 705 

5.5.7.11.4 Test procedure 705 

5.5.7.12 Services Allocation 706 

5.5.7.12.1 Conformance requirement 706 

5.5.7.12.2 Test area files 706 

5.5.7.12.3 Test coverage 706 

5.5.7.12.4 Test procedure 706 

5.5.8 UICC File Access 707 

5.5.8.1 FileView 707 

5.5.8.1.1 Conformance requirement 707 

5.5.8.1.2 Test area files 708 

5.5.8.1.3 Test coverage 708 

5.5.8.1.4 Test procedure 709 

5.5.8.2 File Access 712 

5.5.9 Other parts transferred to framework from API 712 

5.5.9.1 A handler is a temporary JCRE Entry Point object 712 

5.5.9.1.1 Conformance requirement 712 

5.5.9.1.2 Test area files 712 
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5.5.9.1.3 Test coverage 713 

5.5.9.1.4 Test procedure 713 

5.5.9.2 Transaction 713 

5.5.9.2.1 Conformance requirement 713 

5.5.9.2.2 Test area files 714 

5.5.9.2.3 Test coverage 714 

5.5.9.2.4 Test procedure 714 

5.5.9.3 Timer Id between Applets 715 

5.5.9.3.1 Conformance requirement 715 

5.5.9.3.2 Test area files 715 

5.5.9.3.3 Test coverage 715 

5.5.9.3.4 Test procedure 715 

5.5.10 Registration 715 

5.5.10.1 Event registration 715 

5.5.10.1.1 Conformance requirement 715 

5.5.10.1.2 Test area files 716 

5.5.10.1.3 Test coverage 716 

5.5.10.1.4 Test procedure 716 

5.5.11 UlCC Toolkit Applet 717 

5.5.11.1 Data and function sharing 717 

5.5.11.1.3 Test coverage 718 

5.5.11.1.4 Test procedure 718 

5.5.11.2 Package deletion 718 

5.5.11.2.1 Conformance requirement 718 

5.5.11.2.2 Test area files 719 

5.5.11.2.3 Test coverage 719 

5.5.11.2.4 Test procedure 720 

5.5.11.3 Applet deletion 720 

5.5.11.3.1 Conformance requirement 720 

5.5.11.3.2 Test area files 721 

5.5.11.3.3 Test coverage 721 

5.5.11.2.4 Test procedure 722 

5.5.11.4 Object deletion 724 

5.5.11.4.1 Conformance requirement 724 

5.5.11.4.2 Test area files 724 

5.5.11.4.3 Test coverage 725 

5.5.11.4.4 Test procedure 725 

5.5.12 Proactive Command Handling 725 

5.5.12.1 General behaviour 725 

5.5.12.1.1 Conformance requirement 725 

5.5.12.1.2 Test area files 725 

5.5.12.1.3 Test coverage 725 

5.5.12.1.4 Test procedure 725 

5.5.13 CAT Runtime Environment behaviour 726 

5.5.13.1 Context 726 

5.5.13.1.1 Conformance requirement 726 

5.5.13.1.2 Test area files 726 

5.5.13.1.3 Test coverage 726 

5.5.13.1.4 Test procedure 726 

5.5.14 UICC and ADF File System Administration API 726 

5.5.14.1 AdminFile View 726 

5.5.14.1.1 Conformance requirement 726 

5.5.14.1.2 Test area files 727 

5.5.14.1.3 Test coverage 727 

5.5.14.1.4 Test procedure 727 

5.5.14.2 AdminFile Access 727 

Annex A (normative): Class and methods acronyms 728 

A.l uicc.access package 728 

A.1.1 FileView methods 728 

A.1.2 UlCCConstants 728 
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A.1.3 UlCCSystem methods 728 

A.1.4 UICCException methods 729 

A.2 uicc.toolkit package 729 

A.2.1 BERTLVEditHandler methods 729 

A.2.2 BERTLVViewHandler methods 730 

A.2.3 EditHandler methods 730 

A.2.4 EnvelopeHandler methods 730 

A. 2. 5 EnvelopeResponseHandler methods 731 

A. 2. 6 ProactiveHandler methods 731 

A.2. 7 ProactiveResponseHandler methods 732 

A.2. 8 ToolkitConstants methods 733 

A. 2. 9 Toolkitlnterface methods 733 

A.2. 10 ToolkitRegistry methods 733 

A.2.1 1 ViewHandler methods 734 

A.2. 12 EnvelopeHandlerSystem methods 734 

A.2. 13 EnvelopeResponseHandlerSystem methods 734 

A.2. 14 ProactiveHandlerSystem methods 734 

A.2. 15 ProactiveResponseHandlerSystem methods 734 

A.2. 16 TerminalProfile methods 734 

A.2. 17 ToolkitRegistrySystem methods 734 

A.2. 18 ToolkitException methods 734 

A. 3 uicc.system package 735 

A.3.1 BERTLVEditHandler methods 735 

A.3.2 UlCCPlatfbrm methods 735 

A.4 uicc.access.fileadministration package 735 

A.4.1 AdminFileView methods 735 

A.4. 2 AdminFileViewBuilder methods 736 

A.4. 3 AdminException methods 736 

A. 5 Acronyms for CAT Runtime Environment tests 736 

A.5.1 Minimum handler availability 736 

A.5.2 Handler integrity 736 

A. 5. 3 Applet triggering 737 

A. 5. 4 Proactive command sending by the CAT Runtime Environment 737 
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Intellectual Property Rights 



IPRs essential or potentially essential to the present document may have been declared to ETSI. The information 
pertaining to these essential IPRs, if any, is publicly available for ETSI members and non-members, and can be found 
in ETSI SR 000 314: "Intellectual Property Rights (IPRs); Essential, or potentially Essential, IPRs notified to ETSI in 
respect of ETSI standards", which is available from the ETSI Secretariat. Latest updates are available on the ETSI Web 
server ( http://webapp.etsi.org/IPR/home.asp ). 

Pursuant to the ETSI IPR Policy, no investigation, including IPR searches, has been carried out by ETSI. No guarantee 
can be given as to the existence of other IPRs not referenced in ETSI SR 000 314 (or the updates on the ETSI Web 
server) which are, or may be, or may become, essential to the present document. 



Foreword 

This Technical Specification (TS) has been produced by ETSI Project Smart Card Platform (SCP). 

The contents of the present document are subject to continuing work within EP SCP and may change following formal 
EP SCP approval. If EP SCP decides to modify the contents of the present document, it will be re-released by EP SPC 
with an identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

X the first digit: 

1 presented to EP SCP for information; 

2 presented to EP SCP for approval; 

3 or greater indicates EP SCP approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 
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Scope 



The present document covers the minimum characteristics considered necessary in order to provide compUance to 
TS 102 241 [13]. 

It describes the technical characteristics and methods for testing the UICC API for Java Card^*^ (TS 102 241 [13]) 
implemented in a UICC Platform. It specifies the following parts: 

test applicability; 

test environment description; 

tests format; 

test area reference; 

conformance requirements; 

test area files; 

test coverage; 

test procedure; 

a description of the associated testing tools that shall be used. 



References 



The following documents contain provisions which, through reference in this text, constitute provisions of the present 
document. 

• References are either specific (identified by date of publication and/or edition number or version number) or 
non-specific. 

• For a specific reference, subsequent revisions do not apply. 

• For a non-specific reference, the latest version applies. In the case of a reference to an HP SCP document, a 
non-specific reference implicitly refers to the latest version of that document in the same Release as the 
present document. 

Referenced documents which are not found to be publicly available in the expected location might be found at 
http://docbox.etsi.org/Reference . 

[1] ISO/IEC 7816-3 (2006): "Identification cards - Integrated circuit cards - Part 3: Cards with 

contacts - Electrical interface and transmission protocols ". 

[2] Sun Microsystems Java Card^^ Specification: "Java Card''^ 2.2.1 Application Programming 

Interface". 

[3] Sun Microsystems Java Card'"*^ Specification: "Java Card'^ 2.2.1 Runtime Environment (JCRE) 

Specification". 

[4] Sun Microsystems Java Card'"*^ Specification: "Java Card^"^ 2.2.1 Virtual Machine Specification". 

NOTE: SUN Java Card Specifications can be downloaded at http://iava.sun.com/products/iavacard 

[5] ETSI TS 101 220: "Smart Cards; ETSI numbering system for telecommunication application 

providers (Release 6)". 

[6] ETSI TS 102 221: "Smart cards; UICC-Terminal interface; Physical and logical characteristics 

(Release 6)". 
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[7] ETSI TS 102 223: "Smart cards; Card Application Toolkit (CAT) (Release 6)". 

[8] ETSI TS 102 222: "Integrated Circuit Cards (ICC); Administrative commands for 

telecommunications applications (Release 6)". 

[9] ETSI TS 102 225: "Smart Cards; Secured packet structure for UICC based applications 

(Releasee)". 

[10] ETSI TS 102 226: "Smart Cards; Remote APDU structure for UICC based applications 

(Releasee)". 

[11] ETSI TS 102 240: "Smart Cards; UICC Application Programming Interface and Loader 

Requirements; Service description; (Release 6)". 

[12] ETSI TS 151 Oil: "Digital cellular telecommunications system (Phase 2+); Specification of the 

Subscriber Identity Module - Mobile Equipment (SIM -ME) interface (3GPP TS 51.01 1 
Release 4)". 

[13] ETSI TS 102 241: "Smart Cards; UICC AppHcation Programming Interface (UICC API) for Java 

Card (TM); (Release 6)". 

[14] ETSI TS 123 040: "Digital cellular telecommunications system (Phase 2+); Universal Mobile 

Telecommunications System (UMTS); Technical realization of Short Message Service (SMS) 
(3GPP TS 23.040)". 

[15] ETSI TS 101 267: "Digital cellular telecommunications system (Phase 2+); Specification of the 

SIM Application Toolkit for the Subscriber Identity Module - Mobile Equipment (SIM-ME) 
interface (3GPP TS 11.14)". 



Definitions and abbreviations 



3.1 Definitions 

For the purposes of the present document, the following terms and definitions apply: 

applet installation parameters: values for applet installation parameters 

Conformance Requirement Reference (CRR): description of the expected card behaviour according to 
TS 102 241 [13] 

expected state: state in which the UICC is supposed to be after the execution of the test procedure applied on the 
relevant initial conditions 

security parameters: minimum security requirements defined for the applet installation process 

test area: set of Test Cases applicable to a specific part (class method, CAT RE behaviour, etc.) of the TS 102 241 [13]. 

test case: elementary test that checks for compliance with one or more Conformance Requirement References 

test procedure: sequence of actions/commands to perform all the test cases defined in a test area 

test source file: Java file containing methods that will load and install test applet in the card, execute and verify the test 
results, and restore the Default Initial Conditions on the UICC (when possible) 

test toolkit applet: applet designed to test a specific functionality of the UICC API (TS 102 241 [13]) 

3.2 Abbreviations 

For the purposes of the present document, the following symbols apply: 

AID Application IDentifier 

APDU Application Protocol Data Unit 
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API Application Programming Interface 

CAT RE Card Application Toolkit Runtime Environment 

CRR Conformance Requirements Reference 

CRRC Conformance Requirement Reference Context Error 

CRRN Conformance Requirement Reference Normal 

CRRP Conformance Requirement Reference Parameter Error 

JCRE Java Card''^ Runtime Environment 



4 



Test environment 



This clause specifies requirements that shall be met and the testing rules that shall be followed, during the test 
procedure. 



4.1 Applicability 



The test defined in the present document are applicable to cards implementing TS 102 241 [13] unless otherwise stated. 



4.2 Test environment description 

The general architecture for the test environment is; 



Scope of the Test Suite. 
, Elements of the Test Suite 




NOTE: Figure 4.2 shows the test architecture required to test interoperability at both API and bytcode level. The 
latter is currently not included in the current specification. The diagram is for information. 

Figure 4.2 
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4.3 Tests format 
4.3.1 Test area reference 

Each test area is referenced as follows: 
API Testing: 'Api_[package name]_[class name]_[method name]' where: 

• package name: 

uicc.access package: '1'. 
uicc. toolkit package: '2'. 
uicc.system package: '3'. 
uicc. access. fileadministration: '4'. 

• class/interface name: 

yyy: 3 letters for each class. 
NOTE 1 : See annex A for full classes acronyms list. 

• method name: 

zzzz [input parameters]. 
NOTE 2: See annex A for full methods name acronyms list. 
CRE: Cat Runtime Environment testing: 'Cre_[Clause name]_[Subclause name]': 

• Clause name: 

xxx: 3 letters for each clause 
NOTE 3: See annex A for full clause acronyms list. 

• Subclause name 

yyyy: : 4 letters for each subclause 
NOTE 4: See annex A for full subclause acronyms list. 

4.3.1.1 Conformance requirements 

The conformance requirements are expressed in the following way: 

• Method prototype as listed in TS 102 241 [13]. 

• Normal execution: 

Contains normal execution and correct parameters limit values, each referenced as a Conformance 
Requirement Reference Normal (CRRN). 

• Parameter errors: 

Contains parameter errors and incorrect parameter limit values, each referenced as a Conformance 
Requirement Reference Parameter Error (CRRP). 

• Context errors: 

Contains errors due to the context the method is used in, each referenced as a Conformance Requirement 
Reference Context Error (CRRC). 
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4.3.1.2 Test area files 

The files included in the Test Area use the following naming convention: 

Test Source: Test_[Test Area Reference]. Java. 

Test Applet: [Test Area Reference]_[Test applet numberj.java. 

Cap File: [Test Area Reference]. cap. 

The applet numbers start from '1'. 

The test source shall use common interfaces defined in annex D. 
The Cap File format is described in Java Card^"^ Virtual Machine Specification [4]. 
Test files can be run in any order. 
All files from the same test area are located in the same subfolder. 



4.3.1.3 



Test coverage 



The table above each test procedure indicates the correspondence between the Conformance Requirements Reference 
(CRR) and the different test cases. 

4.3.1 .4 Test procedure 

Each test procedure contains a table to indicate the expected responses from the API and/or the APDU level as follows: 



Test Case 


Id 


Description 


API/CAT RE Expectation 


APDU Expectation 




Test Case detailed description 


API and/or CAT RE expected behaviour. 


Expected response at APDU level. 



4.4 



Initial conditions 



The Initial Conditions are a set of general prerequisites for the UICC prior to the execution of testing. For each test 
procedure described in the present document, the following rules apply to the Initial Conditions: 

unless otherwise stated, the file system and the files' content shall fulfil the requirements described in annex B; 

unless otherwise stated, before installing the applet(s) relevant to the current test procedure, all packages 
specific to other test procedures shall not be present. 

When both statements apply, a test procedure is said to be in the "Default Initial Conditions" state. 



4.5 Package name 



Java packages integrating this Test Suite shall follow this naming convention: 

uicc.test.access.[Test Area Reference]: Java Card packages containing Test Area References for the TS 102 241 [13] 
uicc. access package. 

uicc.test.system.[Test Area Reference]: Java Card packages containing Test Area References for the TS 102 241 [13] 
uicc. system package. 

uicc.test.toolkit.[Test Area Reference]: Java Card packages containing Test Area References for the TS 102 241 [13] 
uicc. toolkit package. 

uicc.test.access.fileadniinistration.[Test Area Reference]: Java Card packages containing Test Area References for 
the TS 102 241 [13] uicc. access. fileadministration package. 
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uicc.test.catre.[Test Area Reference]: Java Card packages containing Test Area References for the TS 102 241 [13] 
CAT Runtime Environment. 

uicc.test.util: for the Test util package defined in this Test Suite. 

where the Test Area Reference is written in lower case. 

EXAMPLE: The package ../uicc.test.access. [Test Area Reference] creates the following directory structure 
../uicc/test/access/[Test Area Reference]/Api_l _..._[ l..n].*, where Api_l_..._[l..n].*' are the 
different test applets Java source files used in [Test Area Reference] . 



4.6 AID Coding 



The AID coding for the Test Packages, Applet classes and Applets shall be as specified in TS 101 220 [5]. In addition, 
the following TAR and Application Provider specific data values are defined for use within the present document: 

AID coding 




Byte 12 | Byte 13 | Byte 14 | Byte 15 | Byte 16 



Application Provider specific data 



TAR 



Specified in TS 101 220 [5] 



TAR Coding (3 bytes/ 24 bits): 



Ib1l 


1 b4 1 b5 L 


1 b8 1 b9 1 


Jb12|b13| 


|b16|b17| 


|b24| 




















1 


Applet instance number 




Applet class number 










Package number 












RFU 














Test Part Identifier 



Applet instance number. Applet Class number. Package number: 

• For package AID, package number shall start from and class and instance numbers shall be 0. 

• For class AID, package number is the number of the class package, class number shall start from 1 and 
instance shall be 0. 

• For instance AID, package and class number are the number of class and package of which instance belongs, 
and instance number shall start from 1. 

Test part Identifier (bits bl-b4): 

0000 reserved (as TAR= '00.00.00' is reserved for Issuer Security Domain). 

0001 API uicc. access. 

0010 API uicc.toolkit. 

0011 API uicc. system. 

0100 API uicc.access.fileadministration. 

0101 CAT RE. 
1101 ADF2. 
1110 ADFl. 
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• 1111 uicc.util. 

• other values are RFU. 
Application Provider specific data (1 byte): 

• '00' for Package. 

• '01' for Applet class. 

• '02' for Applet Instance. 

EXAMPLE: The AID of Package uicc.util is 'AO 00 00 00 09 00 05 FF FFFFFF89 FO 00 00 00'. 

4.7 Test equipment 

These clauses recommend a minimum specification for each of the items of test equipment referenced in the tests. 

4.7.1 Test tool 

This test tool shall meet the following requirements: 

• be able to send and receive APDU command to the UlCC; 

• the result of the I/O commands must be presented at the application layer; 

• be able to provide results of the tests; 

• shall send and/or compare all data specified in test file. 

4.7.2 Interfaces and classes use 

The test tool shall use some interfaces and classes, defined in annex D. They define the only allowed methods to write 
the test sources. 

Interfaces and classes are defined as follow: 

UiccAdministrativeCommandsService defines administrative methods from TS 102 222 [8]; 

UiccApplicationManagementService defines methods to load, install, select and delete applications; 

UiccCardManagementService defines methods to manage the card and its files; 

UiccToolkitService defines methods to manage toolkit commands; 

APDUResponse defines method to retrieve and check status words and data received from the card; 

UiccAPITestCardService defines the static method to get a reference of the class implementing all interfaces; 

UiccTestModel is an abstract class which shall be extended by every test source class; it defines the entry point 
run() method of the test script. 

4.7.3 Util package 

Annex D includes Java source code of TestToolkitApplet abstract class of the uicc.util package. Each test applet shall 
extend this abstract class in order to retrieve test results when selecting it. 

4.7.4 Java Software Development kit version 

Java software development kit (SDK) version supported by JavaCard 2.2.1 specifications ([2], [3], [4]) is 1.4.1. 
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Test plan 



5.1 Package uicc.access 
5.1.1 Interface FileView 
5.1.1.1 Method activateFile 

Test Area Reference: Api_l_Fvw_Actf 

5.1.1.1.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void activateFile ( ) 

throws UICCException 

5.1.1.1.1.1 Normal execution 

• CRRNl: The currently selected EF of the calling applet shall be activated, as defined in TS 102 222 [8]. 



5.1.1.1.1.2 

No requirements. 

5.1.1.1.1.3 



Parameter errors 



Context errors 



• CRRCl: If the calling applet has currently no EF selected, an instance of UICCException shall be thrown. The 
reason code shall be UICCException.NO_EF_SELECTED. 

• CRRC2: If the calling applet does not fulfil the access condition, activate, to perform this function, an instance 
of UICCException shall be thrown. The reason code shall be 
UICCException.SECURITY_STATUS_NOT_SATISFIED. 

• CRRC3: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
UICCException shall be thrown. The reason code shall be UICCException.INTERNAL_ERROR. 

5.1.1.1.2 Test area files 

Test Source: Test_Api_l_Fvw_Actf.java 

Test Applet: Api_l_Fvw_Actf_l.java 

Cap File: api_l_fvw_actf.cap 

5.1.1.1.3 Test coverage 



CRR number 


Test case number 


N1 


2,3 


CI 


1 


C2 


4 


C3 


Not testable 
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5.1.1.1.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Test applet is installed with no access 
right on Application Pin2 






1 


No EF is selected 

1- Select DFiEST fid=llll 

2- Call activateFileO 


2- A UlCCException 
NO_EF_SELECTED is 
thrown 




2 


Activate deactivated File 

0- Select Root directory 

1- Select EFoiGc fid=2FFF 

2- ReadBinary EFuicc 

3- Deactivate EFuicc 

4- ReadBinary EFoicc 

5 -ActivateFile EFuicc 
6- ReadBinary EFuicc 


2- No Exception shall be 

thrown 

4- 

UlCCException.REF DATA 

INVALIDATED is thrown 

6- No Exception shall be 

thrown 




3 


Activate activated File 

ActiveFile EFuicc 


No Exception shall be thrown 




4 


Access condition not fulfilled 

1- Select DFiEST fid=llll 

2- Select EFlada fid=6F15 

3- ActivateFile EFlada 


3- A UlCCException 
SECURITY STATUS NOT 
SATISFIED is thrown 





5.1.1.2 Method deactivateFile 

Test Area Reference: Api_l_Fvw_Dacf. 

5.1 .1 .2.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void deactivateFile ( ) 

throws UlCCException 

5.1.1.2.1.1 Normal execution 

• CRRNl: The currently selected EF of the calling applet shall be deactivated, as defined in TS 102 222 [8]. 

5.1.1.2.1.2 Parameter errors 
No requirements. 

5.1.1.2.1.3 Context errors 

• CRRCl : If the calling applet has currently no EF selected, an instance of UlCCException shall be thrown. The 
reason code shall be UICCException.NO_EF_SELECTED. 

• CRRC2: If the calling applet does not fulfil the access condition, activate, to perform this function, an instance 
of UlCCException shall be thrown. The reason code shall be 
UICCException.SECURITY_STATUS_NOT_SATISFIED. 

• CCRC3: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
UlCCException shall be thrown. The reason code shall be UICCException.INTERNAL_ERROR. 
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5.1.1.2.2 

Test Source: 
Test Applet: 
Cap File: 

5.1.1.2.3 



Test area files 

Test_Api_l_Fvw_Dacf.java. 
Api_l_Fvw_Dacf_l .Java. 
api_ 1 _fv w_dacf . cap . 

Test coverage 



CRR number 


Test case number 


N1 


2,3 


C1 


1 


C2 


4 


C3 


Not testable 



5.1.1.2.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Test applet is installed with no access 
right on Application Pin2 






1 


No EF is selected 

1- select DFiEST fid=llll 

2- call deactivateFile 


2- An UlCCException 
NO_EF_SELECTED is 
thrown 




2 


Deactivate activated File 

0- Select root directory 

1- Select EFoicc fid=2FFF 

2- ReadBinary EFuicc 

3- Deactivate EFuicc 

4- ReadBinary EFuicc 


2- No Exception shall be 

thrown 

4- 

UlCCException.REF DATA 

INVALIDATED is thrown 




3 


Deactivate deactivated File 

1- deactivateFile EFuicc 

2- activateFile EFuicc 


1- No Exception shall be 
thrown 




4 


Access condition not fulfilled 

1- select DFiEST fid=llll 

2- select EFlada fid=6F15 

3- deactivateFile EFlada 


3- An UlCCException 
SECURITY STATUS NOT 
SATISFIED is thrown 
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5.1 .1 .3 Method increase 

Test Area Reference: Api_l_Fvw_Incr. 

5.1 .1 .3.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short increase (byte [ ] incr, 

short incrOffset, 
short incrLength, 
byte [ ] resp, 
short respOffset) 
throws Java . lang. NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
UICCException 

5.1.1.3.1.1 Normal execution 

• CRRNl: This method increases the current cyclic EF record. 

• CRRN2: The response buffer will only contain the value of the increased record. 

5.1.1.3.1.2 Parameter errors 

• CRRPl : If the array incr is null, an instance of NullPointerException shall be thrown. 

• CRRP2: If the array resp is null, an instance of NullPointerException shall be thrown. 

• CRRP3: If incrOffset is negative, an instance of ArraylndexOutOfBoundsException shall be thrown. 

• CRRP4: If incrLength is negative, an instance of ArraylndexOutOfBoundsException shall be thrown. 

• CRRP5: If respOffset is negative, an instance of ArraylndexOutOfBoundsExceptoin shall be thrown. 

• CRRP6: If incrOffset plus incrLength, is greater than the length of array incr, an instance of 
ArraylndexOutOfBoundsException shall be thrown and no increase is performed. 

• CRRP7: If respOffset is greater than the length of array resp, an instance of 
ArraylndexOutOfboundsException shall be thrown. 

• CRRP8: If the result of the addition is greater than the maximum value of the record (represented by all bytes 
set to 'FF'), an instance of UICCException shall be thrown. The reason code shall be 
UICCException.MAX_VALUE_REACHED. 

• CRRP9: If incrLength is greater than 127, and exception shall be thrown. 

5.1.1.3.1.3 Context errors 

• CRRCl : If the calling applet has currently no EF selected, an instance of UICCException shall be thrown. The 
reason code shall be UICCException.NO_EF_SELECTED. 

• CRRC2: If the method call causes a memory problem (e.g. memory access error), an instance of 
UICCException shall be thrown. The reason code shall be UICCException.MEMORY_PROBLEM. 

• CRRC3: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
UICCException shall be thrown. The reason code shall be UICCException.INTERNAL_ERROR. 

• CRRC4: If increase not allowed as indicated by the File descriptor byte of the File Descriptor (TS 102.221 [6] 
Response for an EF), or the file is not a cyclic one, an instance of the UICCException shall be thrown. The 
reason code shall be UICCException.COMMAND_INCOMPATIBLE. 

• CRRC5: If the calling applet does not fulfil the access condition, INCREASE, to perform this function, an 
instance of UICCException shall be thrown. The reason code shall be 
UICCException.SECURITY_STATUS_NOT_SATISFIED. 
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• CRRC6: If the currently selected EF is invalidated, an instance of UICCException shall be thrown. The reason 
code shall be UICCException.REF_DATA_INVALIDATED. 

• CRRC7: If the currently selected cyclic EF has no record, an instance of UICCException shall be thrown. The 
reason code shall be UICCException. RECORD_NOT_FOUND. 



5.1.1.3.2 

Test Source: 
Test Applet: 
Cap File: 

5.1.1.3.3 



Test area files 

Test_Api_l_Fvw_Incr.java. 
Api_ 1 _Fvw_Incr_ 1 .j ava. 
api_ 1 _fvw_incr.cap . 

Test coverage 



CRR number 


Test case number 


N1 


1,2,3,16 


N2 


2,3,16 


P1 


4 


P2 


9 


P3 


6 


P4 


5 


P5 


10 


P6 


7 


P7 


11 


P8 


8 


P9 


16 


C1 


1 


C2 


Not testable 


C3 


Not testable 


C4 


12 


C5 


13 


C6 


14 


C7 


15 



5.1.1.3.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


No EF selected 

1- select DFiEST fid=llll 

2- byte [ ] incr = new byte [4] 
byte [ ] resp = new byte [4] 
incrOffset = 
incrLength = 2 
respOffset = 

increase () 


2- An 

UICCException. NO_EF_SEL 

ECTED should be thrown 





ETSI 



Release 6 



42 



ETSI TS 102 268 V6.0.0 (2007-03) 



Id 


Description 


API Expectation 


APDU Expectation 


2 


increase , verify response 

1- select EFcsRo, fid=6F09 

set the record pointer with 

readRecordO in PREVIOUS mode 

2-//Set both record to 00 00 00 

mode = REC_ACC_MODE_PREVIOUS 

data[] = {0x00,0x00,0x00} 

recOffset = 

dataOffset = 

dataLength = 3 

updateRecord ( ) //update Record 1 

updateRecord //update Record 2 

3- incr[] = {0x00,0x00,0x01} 

incrOffset = 

incrLength = 3 

resp. length = 4 

respOffset = 

ret = 3 

increase ( ) 


3- resp[] = 
{0x00,0x00,0x01,0x00} 




3 


increase, verify file 

1- incr []={OxOO, 0x00, 0x00, 0x02} 
incrOffset = 1 

incrLength = 3 
resp. length = 4 
respOffset = 1 
increase () 

2- resp[] = {0x00,0x00,0x00,0x00} 
recNumber = 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 

recOffset = 

resp. length =4 

respOffset = 

respLength = 3 

readRecord () 


1- resp[] = 
{0x00,0x00,0x00,0x03} 

2- respG = 
{0x00,0x00,0x03,0x00} 




4 


incr[] is null 

incr [ ] = null 
incrOffset = 
incrLength = 1 
resp. length = 4 
respOffset = 
increase () 


Shall throw 

java.lang.NullPointerExceptio 

n. 




5 


incrLength< 

incr.length = 4 
incrOffset = 
incrLength = -1 
resp. length = 4 
respOffset = 
increase {) 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsExc 

option. 




6 


incrOffset < 

incr . length = 4 
incrOffset = -1 
incrLength = 1 
resp. length = 4 
respOffset = 
increase () 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsExc 

option. 




7 


IncrOffset + incrLength > incr.length 

incr . length = 4 

incrOffset = 1 

incLength = 4resp. length = 4 

respOffset = 

increase () 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsExc 

option. 
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Id 


Description 


API Expectation 


APDU Expectation 


8 


Reach Maximum Value 

1- incr[0:3] = OxFF 
incrOffset = 
incrLength = 3 
resp.length = 4 
respOffset = 
increase () 

2- //Set both record to FF FF FF 
mode = REC_ACC_MODE_PREVIOUS 
data[] = {OxFF, OxFF, OxFF} 
recOffset = 

dataOffset = 

dataLength = 3 

updateRecord //update Record 1 

updateRecord ( ) //update Record 2 

3- incr[] = {0x00,0x00,0x01} 
incrOffset = 
incrLength = 3 
resp.length = 4 
respOffset = 

increase () 


1- Shall throw 

uicc. access. UlCCException 

with reason code 

MAX_VALUE_REACHED. 

2- Shall throw 

uicc. access. UlCCException 

with reason code 

MAX_VALUE_REACHED. 




9 


resp[] is null 

incr . length = 4 
incrOffset = 
incrLength = 1 
resp [ ] = null 
respOffset = 
increase () 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsExc 

option. 




10 


respOffset < 

incr . length = 4 
incrOffset = 
incrLength = 1 
resp.length = 4 
respOffset = -1 
increase () 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsExc 

option. 




11 


respOffset + recordLength > resp.length 

incr. length = 4 
incrOffset = 
incrLength = 3 
resp.length = 3 
respOffset = 2 
increase () 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsExc 

option. 




12 


EF is not Cyclic 

1- select EFiaRo fid= 6F03 

2- incr.length= 3 
incrOffset = 
incrLength = 3 
resp.length = 3 
respOffset = 
increase () 

3 - select EFlaeo, fid=6F0C 

4 - incr.length= 3 
incrOffset = 
incrLength = 3 
resp.length = 3 
respOffset = 
increase ( ) 


2 - Shall throw 
uicc. access. UlCCException 
with reason code 
COMMAND INCOMPATIBL 

E. 

4 - Shall throw 
uicc. access. UlCCException 
with reason code 
COMMAND INCOMPATIBL 

E. 




13 


Access condition not fulfilled 

1- select EFcNic, fid=6F06 

2- incr . length= 3 
incrOffset = 
incrLength = 3 
resp.length = 3 
respOffset = 
increase () 


2 - Shall throw 

uicc. access. UlCCException 

with reason code 

SECURITY STATUS NOT 

SATISFIED. 
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Id 


Description 


API Expectation 


APDU Expectation 


14 


EF is invalidated 

select EFcaro, fid=6F09 

2 - invalidate 

3 - incr.length= 3 
incrOffset = 
incrLength = 3 
resp. length = 3 
respOffset = 
increase ( ) 

4 - rehabilitate 

5- Restore initial content of EFcaru 


3 - Shall throw 

uicc. access. UlCCException 

with reason code 

REF_DATA_INVALIDATED 




15 


Record not found 

1- Create an EF Cyclic with no record 
in folder DFtest, fid=0x2C00 

2- select EF Cyclic with no record, 
fid=0x2C00 

3- incr . length= 3 
incrOffset = 
incrLength = 3 
resp. length = 3 
respOffset = 
increase () 

4- Delete Cyclic EF with no records. 


3- Shall throw 

uicc. access. UlCCException 

with reason code 

RECORD_NOT_FOUND 




16 


incrLength out of range 

1- Create an EF Cyclic with 1 record of 
OxFD length in folder DFtest, fid=0x2CFD 

2- Select EF Cyclic, fid=0x2CFD 

3- Set record to following value 
rec[0..125] = 0; rec [126 .. 253] = OxFF 
with an update record. 

4- incr . length=128 
incrOffset = 1 
incrLength = 127 
resp. length = 128 
respOffset = 

Incr[] initialized to = {0x00,... 
, 0x00, 0x01} 
respOffset = 
ret = OxFD 
increase () 

5- incr.length=128 
incrOffset = 
incrLength = 128 
resp. length = 128 
respOffset = 

Incr [ ] initialized to 
respOffset = 
increase () 

6- Delete EF Cyclic with fid=0x2CFD. 


4-resp[0..125] = 
{0x00, ...,0x00,0x01} and 
resp[126..254] = 
{0x00,..., 0x00} 

5- Shall throw an exception 





5.1 .1 .4 Method readBinary 

Test Area Reference: Api_l_Fvw_Redb. 



5.1.1.4.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

public short readBinary (short fileOffset, 

byte [ 1 resp, 
short respOffset, 
short respLength) 
throws Java . lang. NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
UlCCException 
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5.1.1.4.1.1 Normal execution 

• CRRN 1 : . Reads the data bytes of the current transparent EF, as defined in TS 1 02 22 1 [6] . 

• CRRN2: The sum of respOffset plus respLength is returned, and the data bytes of the currently selected 
transparent file are returned in resp. 

5.1.1.4.1.2 Parameter errors 

• CRRPl : If fileOffset is negative, an instance of UICCException.OUT_OF_FILE_BOUND ARIES shall be 
thrown. 

• CRRP2: If respOffset is negative, an instance of ArraylndexOutOfBoundsException shall be thrown. 

• CRRP3: If respLength is negative, an instace of ArraylndexOutOfBoundsException shall be thrown. 

• CRRP4: If the array resp is null, an instance of NullPointerException shall be thrown. 

• CRRP5: If respOffset plus respLength is greater than the length of the array resp. length, an instance of 
ArraylndexOutOfBoundsException shall be thrown and no read is performed. 

• CRRP6: If fileOffset plus respLength exceeds the length of the file, an instance of UICCException shall be 
thrown. The reason code shall be UICCException.OUT_OF_FILE_BOUND ARIES. 

5.1.1.4.1.3 Context errors 

• CRRCl: If the method call causes an error to occur that is not expected and thus not handled, an instace of 
UICCException shall be thrown. The reason code shall be UICCException.INTERNAL_ERROR. 

• CRRC2: If the currently selected EF is not transparent, an instance of UICCException shall be thrown. The 
reason code shall be UICCException.COMMAND_INCOMPATIBLE. 

• CRRC3: If the calling applet does not fulfil the access condition, READ, to perform this function, an instance 
of UICCException shall be thrown. The reason code shall be 
UICCException.SECURITY_STATUS_NOT_SATISFIED. 

• CRRC4: If the currently selected EF is deactivated and the file status of the EF does not allow for the reading 
of an deactivated file, an instance of UICCException shall be thrown. The reason code shall be 
UICCException.REF_DAT_INVALIDATED. 

• CRRC5:If the calling applet has currently no EF selected, an instance of UICCException shall be thrown. The 
reason code shall be UICCException.NO_EF_SELECTED. 

5.1.1.4.2 Test area files 

Test Source: Test_Api_l_Fvw_Redb.java. 
Test Applet: Api_l_Fvw_Redb_Ljava. 

Cap File: api_l_fvw_redb.cap. 
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5.1.1.4.3 



Test coverage 



CRR number 


Test case number 


N1 


1,2 


N2 


1,2 


P1 


3 


P2 


6 


P3 


7 


P4 


5 


P5 


8 


P6 


4 


C1 


Not testable 


C2 


9 


C3 


10 


C4 


11 


C5 


12 



5.1.1.4.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Read from EFtaru 

1- select DFiEST, fid=llll 
select EFisRo, fid=6F03 

2- fileOffset = 
resp.length = 260 
resp[0:259] = 0x55 
respOffset = 10 
respLength = 250 
readBinary ( ) 


2 - shall return 20. 

resp shall contain the contents of 

EFtaru Starting at index 1 0. 

<Description of resp: 

55 55 55 55 55 55 55 55 55 55 

FFFFFFFFFFFF.. .. FF> 




2 


Read from EFtaru 

fileOffset = 5 
resp.length = 260 
resp[0:259] = 0x55 
respOffset = 10 
respLength = 5 
readBinary ( ) 


shall return 15 

resp shall contain the last 5 bytes of 

EFtaru Starting at index 1 0. 

<Description of resp: 

55 55 55 55 55 55 55 55 55 55 

FFFFFFFFFF55 55.. .. 55 > 




3 


FileOffset is negative 

fileOffset = -1 
respOffset = 
respLength = 10 
readBinary ( ) 


Shall throw uicc. access. UICC 
Exception with reason code 
OUT_OF_FILE_BOUNDARIES. 




4 


FileOffset + respLength > EF length 

fileOffset = 259 
respOffset = 
respLength = 2 
readBinary () 


Shall throw uicc.access.UICC 
Exception with reason code 
OUT_OF_FILE_BOUNDARIES. 




5 


resp[] is null 

fileOffset = 
resp = null 
respOffset = 
respLength = 10 
readBinary () 


Shall throw 
java.lang.NullPointerException. 




6 


respOffset < 

fileOffset = 
respOffset = -1 
respLength = 10 
readBinary ( ) 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsException. 




7 


respLength < 

fileOffset = 
respOffset = 
respLength = -1 
readBinary ( ) 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsException. 




8 


RespOffset + respLength > resp.length 

fileOffset = 
resp.length = 20 
respOffset = 10 
respLength = 11 
readBinary ( ) 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsException. 
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Id 


Description 


API Expectation 


APDU Expectation 


9 


EF is not Transparent 

1- select EFlaru, fid=6F0C 

2- fileOffset = 
respOffset = 
respLength = 1 
readBinary () 


2 - Shall throw uicc.access.UICC 
Exception with reason code 
COMMANDJNCOMPATIBLE. 




10 


Access condition not fulfilled 

1- select EFtrac, fid=6F0E 

2- fileOffset = 
respOffset = 
respLength = 1 
readBinary () 


2- Shall throw uicc.access.UICC 
Exception with reason code 
SECURITY STATUS NOT SATISFIE 
D. 




11 


EF is deactivated 

1 - select EFiARu, fid=6F03 

2 - deactivateFile {) 

3 - readBinary 

4 - activateFile () ) 


3 - Shall throw 

uicc. access. UlCCException with 

reason code 

REF_DATA_INVALIDATED. 




12 


No EF selected 

1- select DFiEsi fid=llll 
2 readBinary () 


2 - Shall throw 

uicc. access. UlCCException with 

reason code NO EF SELECTED. 





5.1 .1 .5 Method read Record 

Test Area Reference: Api_l_Fvw_Redr. 

5.1 .1 .5.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short readRecord (short recNumber, 

byte mode, 
short recOffset, 
byte [ ] resp, 
short respOffset, 
short respLength) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
UlCCException 



5.1.1.5.1.1 



Normal execution 



CRRNl: Reads a record or a part of record of a current linear fixed or cyclic EF into byte array resp and the 
sum of respOffset plus respLength is returned. 

CRRN2: If the access mode is REC_ACC_MODE_CURRENT the current record will be read and the current 
record pointer shall not be changed. 

CRRN3: If the access mode is REC_ACC_MODE_ ABSOLUTE the record addressed by recNumber will be 
read and the current record pointer shall not be changed. 

CRRN4: If the access mode is REC_ACC_MODE_NEXT the next record relative to the current selected 
record will be selected and read. The record pointer will be incremented. 

CRRN5: If the access mode is REC_ACC_MODE_NEXT and no current record is selected, the first record 
will be selected and read. The record pointer will be incremented. 

CRRN6: If the access mode is REC_ACC_MODE NEXT and the current record pointer, of a cyclic EF, is set 
to the last record, the record pointer is set to the first record and the record is read. 
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• CRRN7: If the access mode is REC_ACC_MODE_PREVIOUS the previous record relative to the current 
selected record will be selected and read. 

• CRRN8: If the access mode is REC_ACC_MODE PREVIOUS and no current record is selected, the last 
record will be selected and read. 

• CRRN9:If the access mode is REC_ACC_MODE_PREVIOUS and the current record pointer of a cycUc EF is 
set to the first record, the record pointer is set to the last record in this EF and this record shall be read. 

• CRRNIO: The current record pointer of any other applet shall not be changed. 

5.1.1.5.1.2 Parameter errors 

• CRRPl : If the currently selected EF is linear fixed and the access mode is REC_ACC_MODE_ABSOLUTE 
and recNumber is less than or greater than records available, an instance of UICCException shall be thrown. 
The reason code shall be UICCException.RECORD_NOT_FOUND. 

• CRRP2: If the currently selected EF is Unear fixed and the access mode is REC_ACC_MODE_CURRENT, 
recNumber is and there is no current record selected, an instance of UICCException shall be thrown. The 
reason code shall be UICCException.RECORD_NOT_FOUND. 

• CRRP3: If the currently selected EF is linear fixed and the access mode is REC_ACC_MODE_NEXT and the 
current record pointer is set to the last record, an instance of UICCException shall be thrown. The reason code 
shall be UICCException.RECORD_NOT_FOUND. 

• CRRP4: If the currently selected EF is hnear fixed and the access mode is REC_ACC_MODE_PREVIOUS 
and the current record pointer is set to the first record, an instance of UICCException shall be thrown. The 
reason code shall be UICCException.RECORD_NOT_FOUND. 

• CRRP5: If the specified offset into the selected record recOffset is less than 0, an instance of UICCException 
shall be thrown. The reason code shall be UICCException.OUT_OF_RECORD_BOUND ARIES. 

• CRRP6: If recOffset plus respLength is greater than the record length, an instance of UICCException shall be 
thrown. The reason code shall be UICC Exception.OUT_OF_RECORD_BOUND ARIES. 

• CRRP7: If the access mode is not between 2 and 4 (2 = REC_ACC_MODE_NEXT, etc.), an instance of 
UICCException shall be thrown. The reason code shall be UICC Exception.INVALID_MODE. 

• CRRP8: If the array resp is null, an instance of NullPointerException shall be thrown. 

• CRRP9: If respOffset is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

• CRRPIO: If respLength is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

• CRRPl 1 : If respOffset plus respLength is greater than the length of the array resp. length, or respOffset equals 
resp. length, an instance of ArraylndexOutOfBoundsException shall be thrown. 

5.1.1.5.1.3 Context errors 



• 



CRRCl: If the calling applet has currently no EF selected, an instance of UICCException shall be thrown. The 
reason code shall be UICCException.NO_EF_SELECTED. 

CRRC2: If the currently selected EF is neither linear fixed nor cyclic, an instance of UICCException shall be 
thrown. The reason code shall be UICCException.COMMAND_INCOMPATIBLE. 

CRRC3: If the calling applet does not fulfil the access condition, READ, to perform this function, an instance 
of UICCException shall be thrown. The reason code shall be 
UICCException.SECURITY_STATUS_NOT_SATISFIED. 

CRRC4: If the currently selected EF is invalidated and the file status of the EF does not allow for reading an 
invalidated file, an instance of UICCException shall be thrown. The reason code shall be 
UICCException.REF_DATA_INVALIDATED. 
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CRRC5: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
UICCException shall be thrown. The reason code shall be UICCException.INTERNAL_ERROR. 



5.1.1.5.2 

Test Source: 
Test Applet: 
Cap File: 

5.1.1.5.3 



Test area files 

Test_Api_ 1 _Fvw_Redr.j ava. 
Api_ 1 _Fvw_Redr_ 1 .j ava. 
api_l_fvw_redr.cap. 

Test coverage 



CRR number 


Test case number 


N1 


2, 3,4,5,6,8,9, 10, 11,12,13 


N2 


3,9 


N3 


2,8 


N4 


4,5,10,11 


N5 


4,11 


N6 


11 


N7 


6,7,12,13 


N8 


6,13 


N9 


12 


N10 




P1 


14 


P2 


15 


P3 


5 


P4 


7 


P5 


16 


P6 


17 


P7 


18 


P8 


19 


P9 


20 


P10 


21 


P11 


22 


C1 


1 


C2 


23 


C3 


24 


C4 


25 


C5 


Not testable 



5.1.1.5.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


No EF selected 

1- select DFiEST, fid=llll 








2- recNumber = 1 

mode = REC_ACC_MODE_ABSOLUTE 

recOffset = 

byte[] resp = new byte[20] 


2-Shall throw 

uicc.access. UICCException with 

reason code NO_EF_SELECTED. 






respOffset = 








respLength = 10 








readRecord {) 
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Id 


Description 


API Expectation 


APDU Expectation 


2 


Read Absolute from Linear Fixed EF 

1 - select EFlaro, fid=6F0c 
// Record pointer not set. 

2 - recNumber = 2 

mode = REC„ACC_MODE_ABSOLUTE 

recOffset = 

respOffset = 

respLength = 4 

readRecord ( ) 

3- recNumber = 

mode = REC_ACC_MODE_NEXT 

recOffset = 

respOffset = 

respLength = 4 

readRecord {) 


2 - resp shall be: 
resp={OxAA,OxAA,OxAA,OxAA} 

3- resp shall be: 
Resp={0x55, 0x55, 0x55, 0x55} 




3 


Read Current from Linear Fixed EF 

//record pointer shall not be changed 

1- recNumber = 

mode = REC_ACC_MODE_CURRENT 

recOffset = 

respOffset = 

respLength = 4 

readRecord ( ) 


resp shall be: 
resp={0x55,0x55,0x55,0x55} 




4 


Read Next from Linear Fixed EF 

1- select EFlaru, fid=6F0c 
//no record selected 
recNumber = 

mode = REC_ACC_MODE_NEXT 
recOffset = 
respOffset = 
respLength = 4 
readRecord () 

2- recNumber = 

mode = REC_ACC_MODE_NEXT 
recOffset = 
respOffset = 
respLength = 4 
readRecord ( ) 


1- resp shall be: 
resp={0x55,0x55, 0x55, 0x55} 

2- resp shall be: 
resp={0xAA,0xAA,0xAA,0xAA} 




5 


Read Next from Linear Fixed EF 

recNumber = 
mode = REC_ACC_MODE_NEXT 
recOffset = 
respOffset = 
respLength = 4 
readRecord ( ) 


Shall throw uicc.access.UICC 
Exception with reason code 
RECORD_NOT_FOUND. 




6 


Read Previous from Linear Fixed EF 

1- recNumber = 

mode = REC_ACC_MODE_PREVIOUS 
recOffset = 
respOffset = 
respLength = 4 
readRecord ( ) 

2- select EFlaro, fid=6F0c 
//no record selected 
recNumber = 

mode = REC_ACC_MODE_PREVIOUS 
recOffset = 
respOffset = 
respLength = 4 
readRecord ( ) 


1- resp shall be: 
resp={0x55, 0x55, 0x55, 0x55} 

2- resp shall be: 
resp={0xAA,0xAA,0xAA,0xAA} 




7 


Read Previous from Linear Fixed EF 

recNumber = 

mode = REC_ACC_MODE_PREVIOUS 

recOffset = 

respOffset = 

respLength = 4 

readRecord ( ) 


Shall throw 

uicc. access. UlCCException with 
reason code RECORD 
NOT FOUND. 
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Id 


Description 


API Expectation 


APDU Expectation 


8 


Read Absolute from Cyclic EF 

1 select EFcaro, fid = 6F09 

2- recNumber = 2 

mode = REC_ACC_MODE_ABSOLUTE 
recOffset = 
respOffset = 
respLength = 3 
readRecord () 

3- recNumber = 1 
readRecord ( ) 


2 - resp shall be: 
resp={OxAA,OxAA,OxAA} 

3 - resp shall be: 
resp={OxAA,OxAA,OxAA} 




9 


Read Current from Cyclic EF 

//record pointer shall not be changed 

//from testcase before 

1- recNumber = 

mode = REC_ACC_MODE_CURRENT 

recOffset = 

respOffset = 

respLength = 3 

readRecord () 


1- resp shall be: 
resp={OxAA,OxAA,OxAA} 




10 


Read Next from Cyclic EF 

recNumber = 
mode = REC_ACC_MODE_NEXT 
recOffset = 
respOffset = 
respLength = 3 
readRecord {) 


resp shall be: 
resp={OxAA,OxAA,OxAA} 




11 


Read Next from Cyclic EF 

1- recNumber = 

mode = REC„ACC„MODE_NEXT 
recOffset = 
respOffset = 
respLength = 3 
readRecord () 

2- select EFcaro, fid = 6F09 
//no rec selected 
recNumber = 

mode = REC_ACC_MODE_NEXT 
recOffset = 
respOffset = 
respLength = 3 
readRecord {) 


1- resp shall be: 
resp={0x55, 0x55, 0x55} 

2- Shall throw 

uicc. access. UlCCException with 
reason code RECORD_NOT_FOUND. 




12 


Read Previous from Cyclic EF 

1- recNumber = 

mode = REC_ACC„MODE_PREVIOUS 

recOffset = 

respOffset = 

respLength = 3 

readRecord ( ) 


1- resp shall be: 
resp={OxAA,OxAA,OxAA} 




13 


Read Previous from Cyclic EF 

1- recNumber = 

mode = REC_ACC_MODE_PREVIOUS 
recOffset = 
respOffset = 
respLength = 3 
readRecord () 

2- select EFcaro, fid = 6F09 
// no rec selected 
recNumber = 

mode = REC_ACC_MODE_PREVIOUS 
recOffset = 
respOffset = 
respLength = 3 
readRecord 


1- resp shall be: 
resp={0x55,0x55,0x55} 

2- resp shall be: 
resp={0xAA,0xAA,0xAA} 
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Id 


Description 


API Expectation 


APDU Expectation 


14 


Read Absolute from Linear Fixed EF beyond 
Records 

1- select EFlaro, fid=6F0C 

2- recNumber = -1 

mode = REC_ACC_MODE_ABSOLUTE 
recOffset = 
respOffset = 
respLength = 4 
readRecord ( ) 

3- recNumber = 3 
readRecord () 


2- Shall throw an 

uicc. access. UlCCException with 

reason code 

UlCCException. RECORD NOT FOU 

ND. 

3- Shall throw an 

uicc. access. UlCCException with 

reason code 

UlCCException. RECORD NOT FOU 

ND. 




15 


No current record in linear fixed EF, read 
current 

1- select EFlaro, fid=6F0C // No current 
record 

2- recNumber =0 // curr rec 
mode = REC_ACC_MODE„CURRENT 
recOffset = 

respOffset = 
respLength = 4 
readRecord ( ) 


2 - Shall throw uicc.access.UICC 
Exception with reason code 
RECORD_NOT_FOUND. 




16 


recOffset < 

1- select EFlaro, fid=6F0C 

2- recNumber =1 // rec 1 
mode = REC_ACC_MODE_ABSOLUTE 
recOffset = -1 
respOffset = 
respLength = 4 
readRecord ( ) 


2 - Shall throw 

uicc. access. UlCCException with 

reason code 

OUT_OF_RECORD_BOUNDARIES. 




17 


recOffset + respLength > Record Length 

1- select EFlaro, fid=6F0C 

2- recNumber = 1 

mode = REC_ACC_MODE_ABSOLUTE 
recOffset = 2 
respOffset = 
respLength = 4 
readRecord () 


2 - Shall throw 

Sim. access. SIMViewException with 

reason code 

OUT_OF_RECORD_BOUNDARIES. 




18 


Reading with invalid mode 

1- select EFlaro, fid=6F0C 

2- recNumber = 
mode = 1 
recOffset = 
respOffset = 
respLength = 4 
readRecord () 

3- mode = 5 
readRecord ( ) 


2 - Shall throw 

uicc. access. UlCCException with 
reason code INVALID_MODE 

3 - Shall throw uicc.access. 
UlCCException with reason code 
INVALID MODE. 




19 


resp is null 

resp [ ] = null 

mode = REC_ACC_MODE_CURRENT 

respOffset = 

respLength = 10 

readRecord {) 


Shall throw 
java.lang.NullPointerException. 




20 


respOffset < 

respOffset = -1 
respLength = 10 
readRecord () 


Shall throw 

java.lang.ArraylndexOutOfBoundsExce 

ption. 




21 


respLength < 

respOffset = 
respLength = -1 
readRecord () 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsException. 




22 


respOffset + respLength > resp.length 

respOffset = 10 
respLength = 11 
readRecord () 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsException. 
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Id 


Description 


API Expectation 


APDU Expectation 


23 


EF is neither Cyclic nor Linear Fixed 

1- select EFtnu, fid=6F02 








2- respOffset = 


2 - Shall throw 






respLength = 4 
readRecord () 


uicc. access. UlCCException with 

reason code 

COMMAND INCOMPATIBLE. 




24 


Access condition not fulfilled 

1- select EFcNR, fid=6F04 








2 - respLength = 3 


2 - Shall throw 






readRecord () 


uicc. access. UlCCException with 

reason code 

SECURITY STATUS NOT SATISFIE 

D. 




25 


EF is deactivated 

1 - select EFcNu, fid=6F05 
deactivateFile () 








2 - readRecord 

3 - activateFile 


2 - Shall throw uicc.access.UICC 
Exception with reason code 
REF DATA INVALIDATED 





5.1.1.6 Method search Record 

Test Area Reference: Api_l_Fvw_Sear. 



5.1.1.6.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

public short searchRecord (byte mode, 

short recordNum, 
short searchlndication, 
byte [ ] patt, 
short pattOffset, 
short pattLength, 
short [] response, 
short respOffset, 
short respLength) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
UlCCException 

5.1.1.6.1.1 Normal execution 

• CRRN 1 : Search a given pattern in byte array patt[] of a current linear fixed or cyclic EF. 

• CRRN2: If the pattern is found, the number of each record is stored in byte array response[] and the total 
number of updated bytes in the array response [] buffer is returned. 

• CRRN3: If the value of respLength is greater than the number of records found, the whole response is copied 
into the response buffer and the number of elements copied is returned by the method. 

• CRRN4: If the value of respLength is smaller than the number of found patterns, the first record numbers are 
copied into the response array and the value of respLength is returned. 

• CRRN5: If mode is SIMPLE_SEARCH_START_FORWARD, the search starts at the given record number 
forward towards the end of the file. 

• CRRN6: If mode is SIMPLE_SEARCH _START_BACKWARD, the search starts at a given record number 
backward towards to the beginning of the file. 

• CRRN7: If mode is ENHANCED_SEARCH and 
SEARCH_INDICATION_START_BACKWARD_FROM_PREVIOUS is set in searchlndication, the search 
is backward starting from previous record towards to the beginning of the file. 
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• CRRN8 : If the mode is ENHANCED_SEARCH and 
SEARCH_INDICATION_START_BACKWARD_FROM_PREVIOUS_GR is set in searchlndication, the 
search is backward starting at a given record from previous record towards to the beginning of the file. 

• CRRN9: If the mode is ENHANCED_SEARCH and 
SEARCH_INDICATION_START_FORWARD_FROM_NEXT is set in searchlndication, the search is 
forward starting at the next record towards the end of the file. 

• CRRN 1 0: If the mode is ENHANCED_SEARCH and 
SEARCH_INDICATION_FORWARD_FROM_NEXT_GR is set in searchlndication, the search is forward 
starting at a given record number towards to the end of the file. 

• CRRN 11 : If the mode is ENHANCED_SEARCH, and bit 4 of the most significant byte of the 
searchlndication is not set, the search starts in the record from the offset (absolute position) given in the less 
significant byte of searchlndication. 

• CRRN12: If the mode is ENHANCED_SEARCH, and bit 4 of the most significant byte of the 
searchlndication is set, the search starts in the record after the first occurrence of the value contained in the less 
significant byte of searchlndication. 

• CRRN 13: If pattern given in patt[] is not found, the method returns 0. 

• CRRN 14: If one or more matches are found the record pointer shall be set to the first record where the search 
pattern was found. 

5.1.1.6.1.2 Parameter errors 

• CRRPl : If mode is not 4, 5 or 6, an instance of UICCException shall be thrown. The reason code shall be 
UICCException.INVALID_MODE. 

• CRRP2: If the pattern array patt is null, an instance of java.lang.NullPointerException shall be thrown. 

• CRRP3: If the response array response is null, an instance of java.lang.NullPointerExceptino shall be thrown. 

• CRRP4: If parameter pattOffset is negative, an instance of java.lang.ArraylndexOutOfBoundsException shall 
be thrown. 

• CRRP5: If parameter pattLength is negative, an instance of java.lang.ArraylndexOutOfBoundsException shall 
be thrown. 

• CRRP6: If parameter respOffset is negative, an instance of java.lang.ArraylndexOutOfBoundsException shall 
be thrown. 

• CRRP7: If parameter respLength negative, an instance of java.lang.ArraylndexOutOfBoundsException shall 
be thrown. 

• CRRP8: If parameter pattOffset plus pattLength are greater than the length of array patt, an instance of 
java.lang.ArraylndexOutOfBoundsException shall be thrown. 

• CRRP9: If parameter respOffset plus respLength are greater than the length of array response a 
ArraylndexOutOfBoundsException shall be thrown. 

• CRRPIO: If parameter recordNum is negative, an instance of UICCException shall be thrown. The reason 
code shall be UICCException.RECORD_NOT_FOUND. 

• CRRPl 1: If parameter recordNum is greather than, the total number of records from the currently selected EF, 
an instance of UICCException shall be thrown. The reason code shall be 
UICCException.RECORD_NOT_FOUND. 

• CRRP12 If pattLength is greater than record size of the currently selected EF an instance of UICCException 
shall be thrown. The reason code shall be UICCException.OUT_OF_FILE_BOUND ARIES. 
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5.1.1.6.1.3 



Context errors 



CRRCl: If the calling applet has currently no EF selected, an instance of UICCException shall be thrown. The 
reason code shall be UICCException.NO_EF_SELECTED. 

CRRC2: If the currently selected EF is not linear fixed or cyclic, an instance of UICCException shall be 
thrown. The reason code shall be UICCException.COMMANDJNCOMPATIBLE. 

CRRC3: If the calling applet does not fulfil the access condition, READ, to perform this function, an instance 
of UICCException shall be thrown. The reason code shall be 
UICCException.SECURITY_STATUS_NOT_SATISFIED. 

CRRC4: If the currently selected EF is deactivated and the file status of the EF does not allow for reading a 
deactivated file, an instance of UICCException shall be thrown. The reason code shall be 
UICCException.REF_DATA_INVALIDATED. 

CRRC5: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
UICCException shall be thrown. The reason code shall be UICCException.INTERNAL_ERROR. 



5.1.1.6.2 

Test Source: 
Test Applet: 
Cap File: 



Test area files 

Test_Api_l_Fvw_Sear.java. 
Api_l_Fvw_Sear_l .Java. 
api_l_fvw_sear.cap. 



5.1.1.6.3 



Test coverage 



CRR number 


Test case number 


N1 


2,3,4,5,6,7,8,9,10,11,28,29,30,31,32,33,34,35,36,37 


N2 


2,3,4,5,6,7,8,9,10,11,28,29,30,31,32,33,34,35,36,37 


N3 


2,3,4,5,6,7,8,9,10,11,28,29,30,31,32,33,34,35,36,37 


N4 


12 


N5 


2,28 


N6 


3,29 


N7 


6,7,34,35 


N8 


8,9,36,37 


N9 


10,11,30,31 


N10 


12,13,32,33 


Nil 


6,8,10,12,30,32,34,36 


N12 


7,9,11,13,31,33,35,37 


N13 


2,3,5,7,9,11,28,31 


N14 


6,7,10,11,30,31,34,35 


PI 


13 


P2 


14 


P3 


15 


P4 


16 


P5 


17 


P6 


18 


P7 


19 


P8 


20 


P9 


21 


P10 


22 


P11 


23 


P12 


24 


C1 


1 


C2 


25 


C3 


26 


C4 


27 


C5 


Not testable 
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5.1.1.6.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


No EF selected 

1- select DFiEST, fid=llll 








2- searchRecord ( ) 


2-shall throw uicc. access. UICC 
Exception with reason code 
NO EF SELECTED. 




2 


Fixed linear EF, 
Simple mode search forward 

1- select EFlsea, fid=6FlA 








2- mode = SIMPLE_SEARCH_START_FORWARD 

recordNum = 1 

patt[] = {OxlO, 0x03, 0x04} 


2- no exception shall be thrown 
Shall return 0. 






pattOffset = 


response shall be: 






pattLength = 1 


response={0, 0,0,0} 






response!] = {0,0,0,0} 








respOffset = 








respLength = 4 








searchRecord () 








3- Simple mode search forward 








mode = SIMPLE_SEARCH_START_FORWARD 








recordNum = 2 








patt[] = {OxlO, 0x03, 0x04} 


3- Shall return 2. 






pattOffset = 1 


response shall be: 






pattLength = 2 


response={0,2,4,0} 






resp. length = 4 








respOffset = 1 








respLength = 3 








searchRecord () 








4- Simple mode search forward 








mode = SIMPLE_SEARCH_START_FORWARD 








recordNum = 








patt [] = {OxlO, 0x03, 0x04} 








pattOffset = 1 








pattLength = 2 


4- Shall return 2. 






resp. length = 4 
respOffset = 1 


response shall be: 






respLength = 3 


response={0, 2,4,0} 






searchRecord () 






3 


Simple mode, search backward 








1- mode = SIMPLE_SEARCH_START_BACKWARD 


1- shall return 0. 






recordNum = 1 

patt []={0x08, OxOA, OxOB} 


response shall be: 

r f^ ^^ ^^ f^ 1 






pattOffset = 


response={0, 0,0,0} 






pattLength = 3 








response}] = {0,0,0,0} 








respOffset = 2 








respLength = 2 








searchRecord ( ) 








2-mode = SIMPLE_SEARCH_START_BACKWARD 








recordNum = 6 








patt []={0x08, 0x09, OxOA, OxOB } 








pattOffset = 1 


2- shall return 3. 






pattLength = 2 


response shall be: 






response!] = {0,0,0,0} 


response={0,4,3,1} 






respOffset = 1 








respLength = 3 








searchRecord ( ) 








3-mode = SIMPLE_SEARCH_START_BACKWARD 








recordNum = 








patt []={0x08, 0x09, OxOA, OxOB } 








pattOffset = 1 








pattLength = 2 








response!] = {0,0,0,0} 


3- shall return 3. 






respOffset = 1 


response shall be: 






respLength = 3 
searchRecord () 


response={0,4,3,1} 
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Id 


Description 


API Expectation 


APDU Expectation 


4 


Enhanced Mode, search backward from 

previous record, start from an offset in 

record. 

1- mode = ENHANCED_SEARCH 
searchIndication= 

SEARCH_INDICATION_BACKWARD_FROM_PREVIOUS 
+ 0x0009 

recordNum = 

patt ! ]={ 0x01, 0x02, 0x03, 0x04} 

pattOffset = 

pattLength = 3 

response!] = {0,0,0,0} 

respOffset = 

respLength = 4 

searchRecord () 

2- mode = ENHANCED_SEARCH 
sear chlndi cat ion= 

SEARCH„INDICATION_BACKWARD_FROM_PREVIOUS 
+0x0000 

recordNum = 

patt !] ={OxOC, OxOD, OxOE, OxOF, 0x01, 0x02 } 

pattOffset = 

pattLength = 5 

response!] = {0,0,0,0} 

respOffset = 2 

respLength = 2 

searchRecord ( ) 


1- shall return 1, 
response shall be: 
resp={3, 0,0,0} 

2- shall return 1 
response shall be: 
response={0, 0,2,0} 




5 


Enhanced Mode, search backward from 
previous record, start from a value in record. 

1- mode = ENHANCED_SEARCH 
sear chlndi cat ion= 

SEARCH_INDICATION_BACKWARD_FROM_PREVIOUS 
+ 0x0810 

recordNum = 

patt ! ]={ 0x01, 0x02, 0x03, 0x04} 

pattOffset = 

pattLength = 3 

response!] = {0,0,0,0} 

respOffset = 

respLength = 4 

searchRecord ( ) 

2- perform 3 readRecordO in next mode 
to set current pointer to pointer 5 

3- mode = ENHANCED_SEARCH 
sear chlndi cat ion= 

SEARCH_1NDICATI0N_BACKWARD_FR0M_PREVL0US 
+0x080E 

recordNum = 

patt !]={ 0x01, 0x02, 0x03, 0x04} 

pattOffset = 3 

pattLength = 1 

response!] = {0,0,0,0} 

respOffset = 

respLength = 4 

searchRecord ( ) 


1- shall return 0, 
response shall be: 
resp={0,0,0,0} 

3- shall return 2 
response shall be: 
response={4,2,0,0} 
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Id 


Description 


API Expectation 


APDU Expectation 


6 


Enhanced Mode, search backward from 

previous given record, start from an offset in 

record. 

1- mode = ENHANCED_SEARCH 
searchIndication= 

SEARCH_INDICATION_BACKWARD_FROM_PREVIOUS 
_GR + 0x0000 

recordNum = 1 
patt []={0x01, 0x02, 0x03} 
pattOffset = 
pattLength = 1 
response!] = {0,0,0,0} 
respOffset = 
respLength = 4 
searchRecord () 

2- mode = ENHANCED_SEARCH 
sear chlndi cat ion= 

SEARCH_INDICATION„BACKWARD_FROM_PREVIOUS 
_GR + 0x0004 

recordNum = 6 
patt !] = {0x01, 0x02, 0x03} 
pattOffset = 
pattLength = 3 
response!] = {0,0,0,0} 
respOffset = 
respLength = 4 
searchRecord ( ) 


1- shall return 1, 
response shall be: 
resp={1, 0,0,0} 

2- shall return 4 
response shall be: 
response={5,4,3,2} 




7 


Enhanced Mode, search backward from 

previous given record, start from a value in 

record. 

1- mode = ENHANCED_SEARCH 
sear chlndi cat ion= 

SEARCH_IND I CAT I ON_BACKWARD_FROM_PREVI OUS 

_GR + OxOSOD 

recordNum = 1 

patt ! ] ={OxOE, OxOE, OxOE} 

pattOffset = 1 

pattLength = 1 

response!] = {0,0,0,0} 

respOffset = 

respLength = 4 

searchRecord () 

2- mode = ENHANCED_SEARCH 
searchIndication= 

SEARCH_INDICATION_BACKWARD_FROM_PREVIOUS 
_GR + 0x0800 

recordNum = 6 
patt !] = {0x01, 0x02, 0x03} 
pattOffset = 
pattLength = 3 
response!] = {0,0,0,0} 
respOffset = 
respLength = 4 
searchRecord ( ) 


1- shall return 1, 
response shall be: 
resp={1, 0,0,0} 

2- shall return 
response shall be: 
response={0, 0,0,0} 
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Id 


Description 


API Expectation 


APDU Expectation 


8 


Enhanced Mode, search forward from next 
record, start from an offset in record. 

1- mode = ENHANCED_SEARCH 
sear chlndi cat ion= 

SEARCH_IND I CAT I ON_FORWARD_FROM_NEXT + 

0x0003 

recordNum = 

patt [ ] ={0x00, OxOA, OxOB} 

pattOffset = 1 

pattLength = 2 

response!] = {0,0,0} 

respOffset = 2 

respLength = 2 

searchRecord () 

2- Perform readRecordO in previous mode 

3- mode = ENHANCED_SEARCH 
sear chlndi cat ion= 

SEARCH_IND I CAT I ON_FORWARD_FROM_NEXT + 

0x0003 

recordNum = 

patt []={OxOO, OxOA, OxOB} 

pattOffset = 1 

pattLength = 2 

response!] = {0,0,0,0} 

respOffset = 

respLength = 4 

searchRecord () 


1- shall return 2 
response shall be: 
resp={0, 0,3,4} 

3- shall return 1 
response shall be: 
response={4, 0,0,0} 




9 


Enhanced Mode, search forward from next 
record, start from a value in record. 

1- mode = ENHANCED_SEARCH 
sear chlndi cat ion= 

SEARCH_INDICATION_FORWARD_FROM_NEXT + 
0x0804 

recordNum = 
patt !] = {0x01, 0x02, 0x03} 
pattOffset = 1 
pattLength = 2 
response!] = {0,0,0,0} 
respOffset = 2 
respLength = 2 
searchRecord ( ) 

2- mode = ENHANCED_SEARCH 
sear chlndi cat ion= 

SEARCH_INDICATION_FORWARD_FROM_NEXT + 
0x0801 

recordNum = 
patt !] = {0x01, 0x02, 0x03} 
pattOffset = 2 
pattLength = 1 
response!] = {0,0,0,0} 
respOffset = 
respLength = 4 
searchRecord () 


1- shall return 0, 
response shall be: 
resp={0, 0,0,0} 

2- shall return 2 
response shall be: 
response={5,6,0,0} 
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Id 


Description 


API Expectation 


APDU Expectation 


10 


Enhanced Mode, search forward from next 
given record, start from an offset in record. 

1- mode = ENHANCED_SEARCH 
sear chlndi cat ion= 

SEARCH_IND I CAT I ON_FORWARD_FROM_NEXT_GR + 

0x0007 

recordNum = 1 

patt !]={0x01, 0x02, 0x03} 

pattOffset = 

pattLength = 3 

response!] = {0,0,0,0} 

respOffset = 1 

respLength = 3 

searchRecord ( ) 

2- mode = ENHANCED_SEARCH 
searchIndication= 

SEARCH_IND I CAT I ON_FORWARD_FROM_NEXT_GR + 

OxOOOC 

recordNum = 3 

patt !]={0x03, 0x02, 0x01} 

pattOffset = 

pattLength = 3 

response!] = {0,0,0,0} 

respOffset = 

respLength = 4 

searchRecord () 


1- shall return 3, 
response shall be: 
resp={0, 3,4,5} 

2- shall return 1 
response shall be: 
response={6, 0,0,0} 




11 


Enhanced Mode, search forward from next 
given record, start from a value in record. 

1- mode = ENHANCED_SEARCH 
sear chlndi cat ion= 

SEARCH_IND I CAT I ON_FORWARD_FROM_NEXT_GR + 

OxOSOD 

recordNum = 5 

patt !] = {0x01, 0x02, 0x03} 

pattOffset = 

pattLength = 3 

response!] = {0,0,0,0} 

respOffset = 

respLength = 4 

searchRecord () 

2- mode = ENHANCED_SEARCH 
searchIndication= 

SEARCH_IND I CAT I ON_FORWARD_FROM_NEXT_GR + 

OxOSOC 

recordNum = 5 

patt !] = {0x01, 0x02, 0x03} 

pattOffset = 

pattLength = 3 

response!] = {0,0,0,0} 

respOffset = 

respLength = 4 

searchRecord ( ) 


1- shall return 0, 
response shall be: 
resp={0, 0,0,0} 

2- shall return 1 
response shall be: 
response={5, 0,0,0} 




12 


Simple mode, total number of found patterns 
exceed response^ 

1- mode = SIMPLE_SEARCH_START_FORWARD 
recordNum = 1 

patt !]={0x01, 0x02, 0x03} 
pattOffset = 
pattLength = 3 
response!] = {0,0,0,0} 
respOffset = 
respLength = 4 
searchRecord ( ) 

2- mode = SIMPLE_SEARCH_START_FORWARD 
recordNum = 1 

patt !]={0x01, 0x02, 0x03} 
pattOffset = 
pattLength = 3 
response!] = {0,0,0,0,0} 
respOffset = 
respLength = 4 
searchRecord () 


1- shall return 4 
response shall be: 
response={1, 2,3,4} 

2- shall return 4 
response shall be: 
response={1,2,3,4,0} 
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Id 


Description 


API Expectation 


APDU Expectation 


13 


Invalid mode 

mode = 0x14 (simple search forward with 

SFI) 

searchIndication= 

recordNum = 2 

patt []={0x01, 0x02, 0x03} 

pattOffset = 1 

pattLength = 2 

response!] = {0,0,0,0,0} 

respOffset = 2 

respLength = 2 

searchRecord {) 


shall throw an uicc. access. UICC 
Exception with reason code 
INVALID_MODE. 




14 


Pattern array is null 

mode = SIMPLE_SEARCH_START_FORWARD 

searchIndication= 

recordNum = 

patt[]= null 

pattOffset = 1 

pattLength = 2 

response!] = {0,0,0,0,0} 

respOffset = 2 

respLength = 2 

searchRecord () 


shall throw an 
java.lang.NullPointerException. 




15 


Response array is null 

mode = SIMPLE_SEARCH_START_FORWARD 

searchIndication= 

recordNum = 

patt []={0x01, 0x02, 0x03} 

pattOffset = 

pattLength = 1 

response [] = null 

respOffset = 

respLength = 5 

searchRecord ( ) 


shall throw an instance of 
java.lang.NullPointerException. 




16 


pattOffset<0 

mode = SIMPLE_SEARCH_START_FORWARD 

searchIndication= 

recordNum = 

patt []={0x01, 0x02, 0x03} 

pattOffset = -1 

pattLength = 1 

response!] = {0,0,0,0,0} 

respOffset = 

respLength = 5 

searchRecord () 


shall throw an instance of 

java.lang.ArraylndexOutOfBoundsExc 

eption. 




17 


pattLength<0 

mode = SIMPLE_SEARCH_START_FORWARD 

searchIndication= 

recordNum = 

patt !]={0x01, 0x02, 0x03} 

pattOffset = 

pattLength = -1 

response!] = {0,0,0,0,0} 

respOffset = 

respLength = 5 

searchRecord () 


shall throw an instance of 

java.lang.ArraylndexOutOfBoundsExc 

eption. 




18 


respOffset <0 

mode = SIMPLE_SEARCH_START_FORWARD 

searchIndication= 

recordNum = 

patt !] = {0x01, 0x02, 0x03} 

pattOffset = 

pattLength = 1 

response!] = {0,0,0,0,0} 

respOffset = -1 

respLength = 5 

searchRecord () 


shall throw an instance of 

java.lang.ArraylndexOutOfBoundsExc 

eption. 
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API Expectation 


APDU Expectation 


19 


respLength <0 

mode = SIMPLE_SEARCH_START_FORWARD 

searchIndication= 

recordNum = 

patt !]={0x01, 0x02, 0x03} 

pattOffset = 

pattLength = 1 

response!] = {0,0,0,0,0} 

respOffset = 

respLength = -1 

searchRecord ( ) 


shall throw an instance of 

java.lang.ArraylndexOutOfBoundsExc 

eption. 




20 


PattOffset + pattLength > patt[] 

mode = SIMPLE_SEARCH_START_FORWARD 

searchIndication= 

recordNum = 

patt !] = { 0x01, 0x02, 0x03} 

pattOffset = 2 

pattLength = 2 

response!] = {0,0,0,0,0} 

respOffset = 1 

respLength = 5 

searchRecord ( ) 


shall throw an instance of 

java.lang.ArraylndexOutOfBoundsExc 

eption. 




21 


RespOffset + respLength > response[] 

mode = SIMPLE_SEARCH_START_FORWARD 

searchIndication= 

recordNum = 

patt !] = {0x01, 0x02, 0x03} 

pattOffset = 

pattLength = 1 

response!] = {0,0,0,0,0} 

respOffset = 3 

respLength = 3 

searchRecord () 


shall throw an instance of 

java.lang.ArraylndexOutOfBoundsExc 

eption. 




22 


recordNum < 

mode = SIMPLE_SEARCH_START_FORWARD 

searchIndication= 

recordNum = -1 

patt!]={0x01, 0x02, 0x03} 

pattOffset = 

pattLength = 1 

response!] = {0,0,0,0,0} 

respOffset = 

respLength = 5 

searchRecord () 


shall throw an uicc. access. UICC 
Exception with reason code 
RECORD_NOT_FOUND 




23 


RecordNum > total number of file records 

1- mode = SIMPLE_SEARCH_START_FORWARD 

searchIndication= 

recordNum = 7 

patt !]={0x01, 0x02, 0x03} 

pattOffset = 

pattLength = 1 

response!] = {0,0,0,0,0} 

respOffset = 

respLength = 5 

searchRecord ( ) 


1- shall throw an uicc.access.UICC 
Exception with reason code 
RECORD NOT FOUND 
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APDU Expectation 


24 


pattlength > record length 

1- mode = SIMPLE_SEARCH_START_FORWARD 
searchIndication= 

recordNum = 3 

patt [16] = {0x55, 0x55,..., 0x55} 
pattOffset = 
pattLength =16 
response[] = {0,0,0,0,0} 
respOffset = 
respLength = 5 
searchRecord ( ) 

2- mode = ENHANCED_SEARCH 
sear chlndi cat ion= 

SEARCH_IND I CAT I ON_FORWARD_FROM_NEXT_GR + 

OxOOOE 

recordNum = 3 

patt []={ 0x01, 0x02, 0x03} 

pattOffset = 

pattLength = 3 

response[] = {0,0,0,0,0} 

respOffset = 

respLength = 5 

searchRecord ( ) 


1- shall throw an 

uicc. access. UlCCException with 
reason code 
OUT_OF_FILE_BOUNDARIES. 

2- shall throw an 

uicc. access. UlCCException with 
reason code 
OUT_OF_FILE_BOUNDARIES. 




25 


Wrong file structure 

1- select EFiDAc, fid=6F0F 

2- searchRecord 


2- shall throw an 

uicc. access. UlCCException with 

reason code 

COMMAND INCOMPATIBLE 




26 


Security status not satisfied 

1- select EFlnr, fid=6F0A 

2- searchRecord 


2- shall throw an 

uicc. access. UlCCException with 

reason code 

SECURITY STATUS NOT SATISFI 

ED 




27 


File deactivated 

1- select EFlaro, fid=6F10 

2- deactivateFile EFlaru 

3- searchRecord ( ) 

4- activateFile {) 


3- shall throw an 

uicc. access. UlCCException with 

reason code DATA INVALIDATED 
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APDU Expectation 


28 


Cyclic EF, Simple mode search forward 

1- select EFcsEA, fid=6FlB 








2- mode = SIMPLE_SEARCH_START_FORWARD 
recordNum = 1 
patt[]={OxlO, 0x03, 0x04} 
pattOffset = 


2- shall return 
response shall be: 
response={0, 0,0,0,0} 






pattLength = 1 








response[] = {0,0,0,0,0} 








respOffset = 








respLength = 5 








searchRecord () 








3- mode = SIMPLE_SEARCH_START_FORWARD 








recordNum = 2 








patt[]={OxlO, 0x03, 0x04} 
pattOffset = 1 


3- Shall either 






pattLength = 2 


return 3 and response shall be: 






response}] = {0,0,0,0,0} 
respOffset = 2 


response={0,0,2,4,1} 
or shall 






respLength = 3 
searchRecord () 
4- updateRecord in previous mode with 


return 2 and response shall be: 
response={0,0,2,4,0} 






value 








{0x03, 0x02, 0x01, 0x03, 0x02 , 0x01 , 0x03, 0x02 








, 0x01, 0x03, 0x02, 0x01, 0x03, 0x02, 0x01} 








(new record 1 is set to previous record 

6) 

5- mode = SIMPLE_SEARCH_START_FORWARD 














recordNum = 2 








patt[]={OxlO, 0x03, 0x04} 








pattOffset = 1 








pattLength = 2 
response[] = {0,0,0,0,0} 


5- Shall return 3. 






respOffset = 2 


response shall be: 






respLength = 3 
searchRecord ( ) 


response={0, 0,2,3,5} 




29 


Cyclic EF, Simple mode search backward 








mode = SIMPLE_SEARCH_START_BACKWARD 


Shall either 






recordNum = 3 

patt []={ 0x10, 0x03, 0x04} 

pattOffset = 1 


return 3 and response shall be: 
response={0,3,2,5,0} 






pattLength = 2 
response!] = {0,0,0,0,0} 


or shall 

return 2 and response shall be: 






respOffset = 1 


response={0,3,2,0,0} 






respLength = 4 








searchRecord {) 






30 


Cyclic EF, Enhanced mode, search forward 

from next record, start from an offset in 

record 








mode = ENHANCED_MODE 

sear chlndi cat ion= 

SEARCH_IND I CAT I ON_S TART_FORWARD_FROM_NEX 

T + 0x0009 


shall return 3 
response shall be: 
response={0,0,4,5,6} 






recordNum = 








patt []={ 0x01, 0x02, 0x03} 








pattOffset = 








pattLength = 3 








response!] = {0,0,0,0,0} 








respOffset = 2 








respLength = 3 








searchRecord () 
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31 


Cyclic EF, Enhanced mode, search forward 

from next record, start from a value in 

record 

mode = ENHANCED_MODE 

searchIndication= 

SEARCH_INDICATION„START_FORWARD_FROM_NEX 

T + 0x0810 

recordNum = 

patt []={0x01, 0x02, 0x03} 

pattOffset = 

pattLength = 3 

response!] = {0,0,0,0,0} 

respOffset = 2 

respLength = 3 

searchRecord () 


shall return 
response shall be: 
response={0,0,0,0,0} 




32 


Cyclic EF, Enhanced mode, search forward 

from next given record, start from an offset 

in record 

mode = ENHANCED_MODE 

searchIndication= 

SEARCH_IND ICAT I ON_S TART_FORWARD_FROM_NEX 

T_GR + 0x0005 

recordNum = 3 

patt []={0x01, 0x02, 0x03} 

pattOffset = 

pattLength = 1 

response!] = {0,0,0,0,0} 

respOffset = 

respLength = 5 

searchRecord ( ) 


shall either 

return 5 and response shall be: 

response={3,4,5,6,1} 

or shall 

return 4 and response shall be: 

response={3,4,5,6,0} 




33 


Cyclic EF, Enhanced mode, search forward 

from next given record, start from a value in 

record 

1- mode = ENHANCED_MODE 
sear chlndi cat ion= 

SEARCH_INDICATION_START_FORWARD_FROM_NEX 
T_GR + 0x0805 

recordNum = 6 
patt !]={OxOE, OxOF, 0x00} 
pattOffset = 
pattLength = 2 
response!] = {0,0,0,0,0} 
respOffset = 
respLength = 5 
searchRecord ( ) 

2- Restore EF initial state (record 1 
shall be assigned to the record that 
content is 

{0x01, 0x02, 0x03, 0x04, 0x05, 0x06, 0x07, 0x08 
, 0x09, OxOA, OxOB, OxOC, OxOD, OxE, OxOF} ) 
using 5 updateRecord ( ) in previous mode 


1- shall either 

return 2 and response shall be: 

response={2,4, 0,0,0} 

or shall 

return and response shall be: 

response={0,0,0,0,0} 




34 


Cyclic EF, Enhanced mode, search 

backward from previous record, start from 

an offset in record 

1- Set current record pointer to record 
6 using 5 readRecordO in next mode 

2- mode = ENHANCED_MODE 
sear chlndi cat ion= 

SEARCH_INDICATION_START_BACKWARD_FROM_PR 
EVIOUS + 0x0003 

recordNum = 
patt !] = {0x02, 0x01, 0x00} 
pattOffset = 
pattLength = 2 
response!] = {0,0,0,0,0} 
respOffset = 3 
respLength = 2 
searchRecord () 


2- shall either 

return 1 and response shall be: 

response={0,0,0,6,0} 

or shall 

return and response shall be: 

response={0,0,0,0,0} 





ETSI 



Release 6 



66 



ETSI TS 102 268 V6.0.0 (2007-03) 



Id 


Description 


API Expectation 


APDU Expectation 


35 


Cyclic EF, Enhanced mode, search 

backward from previous record, start from a 

value In record 

mode = ENHANCED_MODE 

searchIndication= 

SEARCH_INDICATION_START_BACKWARD_FROM_PR 

EVIOUS + 0x0801 

recordNum = 

patt []={0x01, 0x02, 0x03} 

pattOffset = 1 

pattLength = 2 

response!] = {0,0,0,0,0} 

respOffset = 

respLength = 5 

searchRecord () 


shall return 5 
response shall be: 
response={5,4,3,2,1} 




36 


Cyclic EF, Enhanced mode, search 

backward from given record, start from an 

offset In record 

mode = ENHANCED_MODE 

searchIndication= 

SEARCH_INDICATION_START_BACKWARD_FROM_PR 

EVIOUS_GR + 0x0003 

recordNum = 5 

patt !]={0x02, 0x01, 0x00} 

pattOffset = 

pattLength = 2 

response!] = {0,0,0,0,0} 

respOffset = 3 

respLength = 2 

searchRecord ( ) 


shall either 

return 1 and response shall be: 

response={0,0,0,6,0} 

or shall 

return and response shall be: 

response={0, 0,0,0,0} 




37 


Cyclic EF, Enhanced mode, search 

backward from given record, start from a 

value in record 

mode = ENHANCED_MODE 

sear chlndi cat ion= 

SEARCH_INDICATION_START_BACKWARD_FROM_PR 

EVIOUS_GR + 0x0801 

recordNum = 3 

patt !]={0x01, 0x02, 0x03} 

pattOffset = 1 

pattLength = 2 

response!] = {0,0,0,0,0} 

respOffset = 

respLength = 5 

searchRecord ( ) 


Shall either 

return 5 and response shall be: 

response={3,2,1,5,4} 

or shall 

return 3 and response shall be: 

response={3,2,1,0,0} 





5.1 .1 .7 Method select (byte sfi) 

Test Area Reference: Api_l_Fvw_Slctb. 

5.1 .1 .7.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void select (byte sfi) 

throws UICCException 

5.1.1.7.1.1 Normal execution 

• CRRNl : Selects a file by its Short File Identifier in the current directory of the File View. 

• CRRN2: Allows to update the current file without handling the Select Response. 

• CRRN3: The current EF it self can be selected. 

• CRRN4: The file context associated with the File View object is changed after successful execution. 



ETSI 



Release 6 



67 



ETSI TS 102 268 V6.0.0 (2007-03) 



5.1.1.7.1.2 



Parameter errors 



CRRPl: If the file which sfi matches is not in the current directory or no file matches the sfi, an instance of 
UICCException shall be thrown. The reason code shall be UICCException.FILE_NOT_FOUND. 



5.1.1.7.1.3 



Context errors 



• CRRCl; If the method call causes a memory problem (e.g. memory access error), an instance of 
UICCException shall be thrown. The reason code shall be UICCException.MEMORY_PROBLEM. 

• CRRC2: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
UICCException shall be thrown. The reason code shall be UICCException.INTERNAL_ERROR. 



5.1.1.7.2 

Test Source: 
Test Applet: 
Cap File: 



Test area files 

Test_Api_l_Fvw_ Slctb.java. 
Api_l_Fvw_ Slctb _l.java. 
api_l_fvw_ slctb. cap. 



5.1.1.7.3 



Test coverage 



CRR number 


Test case number 


N1 


1,2,4 


N2 


Not testable 


N3 


3 


N4 


5 


PI 


4 


CI 


Not testable 


C2 


Not testable 



5.1.1.7.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Selection possibilities, UICC file system 

1- get a FileView 

UICCSystem.getTheUICCView(CLEAR_ON_RESE 
T) 

2- select DFiest, fid=llll 

3- select with sfi EF™h, sfi=0x01 

4- select with sfi EFinu, sfi=0x02 

5- select with sfi EFcnu, sfi=0x05 


2- no exception shall be thrown 

3- no exception shall be thrown 

4- no exception shall be thrown 

5- no exception shall be thrown 




2 


Selection possibilities, ADF1 

1- get a FileView 

UlCCSy stem . getTheFileView (AID_ADF1 , CLEA 
R_ON_RESET) 

2- select DFiest, fid=llll 

3- select with sfi EFinr, sfi=0x01 

4- select with sfi EFtnu, sfi=0x02 

5- select with sfi EFcnu, sfi=0x05 


2- no exception shall be thrown 

3- no exception shall be thrown 

4- no exception shall be thrown 

5- no exception shall be thrown 




3 


Current EF itself can be selected 

1- get a FileView 

UICCSystem.getTheUICCView(CLEAR_ON_RESE 
T) 

2- select DFiest, fid=llll 

3- select with sfi EFinh, sfi=0x01 

4- select with sfi EFinh, sfi = 0x01 


4- no exception shall be thrown 




4 


FILE_NOT_FOUND 

1- try to select a file with sfi=0x55 


1- shall throw an 

uicc.access. UICCException with 

reason code FILE NOT FOUND 
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5 


File context changed 

1- select EFtaro, sfi=0x03 
read 3 first bytes 

2- select EFtnu, sfi=0x02 
read file content 


1- file content should be 
{OxFF,OxFF,OxFF} 

2- file content should be 
{0x55,0x55,0x55} 





5.1.1.8 Method select (short fid) 

Test Area Reference: Api_l_Fvw_Slcts. 

5.1 .1 .8.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public public void select (short fid) 
throws UICCException 

5.1.1.8.1.1 Normal execution 

• CRRNl : Selects a file of the UICC file system or of an ADF file system by file identifier. 

• CRRN2: Allows to update the current file without handling the Select Response. 

• CRRN3: After selecting an ADF/MF/DF no EF is selected. 

• CRRN4: After selecting a linear fixed EF no record is selected. 

• CRRN5: Any file can be selected by FID which is an immediate child of the current directory. 

• CRRN6: Any DF can be selected by FID which is an immediate child of the parent of the current DP. 

• CRRN7: The parent of the current directory can be selected by the FID. 

• CRRN8: The ADF of the current active application can be selected by the FID. 

• CRRN9: The ADF/MF/EF can always be self selected. 

• CRRNIO: The file context associated with the File View object is changed after successful execution. 



5.1.1.8.1.2 

No requirements. 

5.1.1.8.1.3 



Parameter errors 



Context errors 



CRRCl: If the file with a File Identifier which matches fid could not be found according to the selection rule 
listed in CCRN3, an instance of UICCException shall be thrown. The reason code shall be 
UICCException.FILE_NOT_FOUND. 

CRRC2: If the file with a File Identifier which matches fid could not be found according to the selection rule 
listed in CCRN4, an instance of UICCException shall be thrown. The reason code shall be 
UICCException.FILE_NOT_FOUND. 

CRRC3: If the file with a File Identifier which matches fid could not be found according to the selection rule 
listed in CCRN5, an instance of UICCException shall be thrown. The reason code shall be 
UICCException.FILE_NOT_FOUND. 

CRRC4: If the file with a File Identifier which matches fid could not be found according to the selection rule 
listed in CCRN6, an instance of UICCException shall be thrown. The reason code shall be 
UICCException.FILE_NOT_FOUND. 
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CRRC5: If the method call causes a memory problem (e.g. memory access error), an instance of 
UICCException shall be thrown. The reason code shall be UICCException.MEMORY_PROBLEM. 

CRRC6: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
UICCException shall be thrown. The reason code shall be UICCException.INTERNAL_ERROR. 



5.1.1.8.2 

Test Source: 
Test Applet: 
Cap File: 



Test area files 

Test_Api_l_Fvw_Slcts.java. 
Api_l_Fvw_Slcts_l .Java. 
api_l_fvw_slcts.cap. 



5.1.1.8.3 



Test coverage 



CRR number 


Test case number 


N1 


1,2 


N2 


5 


N3 


5 


N4 


6 


N5 


1,2 


N6 


1,2 


N7 


1,2 


N8 


1,2 


N9 


4 


N10 


Tested in Api 1 Cont, test case 1 and 2 


C1 


3 


C2 


3 


C3 


3 


C4 


3 


C5 


Not testable 


C6 


Not testable 



5.1.1.8.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Get a FileView object, UICC file system 

1- get a FileView 

UICCSystem.getTheUICCView(CLEAR_ON_RESE 

T) 






1 


Selection possibilities 

1- select EFoicc, fid=2FF0 

2- select DFiest, fid=llll 

3- select EFcnu, fid=6F05 

4- select EFiaM, fid=6F16 

5- select DFsnB_iEST, fid=2211 

6- select DFiest, fid=llll 

7- select EFisaa, fid=6F16 

8- select DFiest, fid=llll 

9- select MF, fid=3F00 

10- select DFiest, fid=llll 

11- select EFiMs, fid=6F16 

12- select MF, fid=3F00 


No exception shall be thrown 




2 


Selection possibilities, ADF1 

1- get a FileView 

UICCSystem.getTheFileView (AID_ADF1, CLEA 
R_ON_RESET) 

2- select EFoicc fid=2FF0 

3- select DFiest, fid=llll 

4- select EFcnu, fid=6F05 

5- select EFiaaa, fid=6F16 

6- select DFsnB_iEST, fid=2211 

7- select DFiest, fid=llll 

8- select EFiaaa, fid=6F16 

9- select DFiest, fid=llll 


No exception shall be thrown 
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API Expectation 


APDU Expectation 


3 


No selection of unreachable file 

1- get a FileView 

UICCSystem.getTheUICCView(CLEAR_ON_RESE 
T) 

2- select EFcnu, fid=6F05 

3- select DFtest, fid=llll 

4- select EFtaa, fid=2222 

5- select EFcnu, fid=6F05 

6- select DFsnB_TEST, fid=2211 

7- select EFtaa, fid=2222 

8- select DFtelecok, fid=7F10 


2- A 

UICCException.FILE_NOT_FOUND 

shall be thrown. 

3- No exception shall be thrown 

4- A 

UICCException.FILE_NOT_FOUND 

shall be thrown. 

5- No exception shall be thrown 

6- No exception shall be thrown 

7- No exception shall be thrown 
8- A 

UICCException.FILE_NOT_FOUND 
shall be thrown. 




4 


Self selection 

1- select MF, fid=3F00 

2- select MF, fid=3F00 

3- select DFtest, fid=llll 

4- select DFtest, fid=llll 

5- select EFtaaa, fid=6F16 

6- select EFtaaa, fid=6F16 

7- get a FileView 

UlCCSystem . getTheFileView (AID_ADF1 , CLEA 
R_ON_RESET) 

8- select ADF, fid=7FFF 

9- select ADF, fid=7FFF 


2- No exception shall be thrown 
4- No exception shall be thrown 
6- No exception shall be thrown 

8- No exception shall be thrown 

9- No exception shall be thrown 




5 


EF not selected after MF/DF selection 

1- select MF, fid=3F00 

2- updateRecord 

3- select DFtest, fid=llll 

4- updateRecord 


2- A 

UICCException.NO_EF_SELECTED 
shall be thrown 
4- A 

UICCException.NO_EF_SELECTED 
shall be thrown 




6 


No record is selected after selecting linear 
fixed EF 

1- select MF, 
fid = 3F00 

2- select DFtest, 

3- select EFlaro, 

4 - recNumber = 

mode = REC_ACC_MODE_ CURRENT 

readRecord () 

5- select EFcaro, 

6 - recNumber = 

mode = REC_ACC_MODE_ CURRENT 

readRecord ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 

4 - Shall throw uicc.access.UICC 
Exception with reason code 
RECORD_NOT_FOUND. 

5 - No exception shall be thrown. 

6 - Shall throw uicc.access.UICC 
Exception with reason code 
RECORD_NOT_FOUND. 





5.1 .1 .9 Method select(short fid, byte[] fcp, short fcpOffset, short fcpLength) 

Test Area Reference: Api_l_Fvw_Slctb_bss. 



5.1.1.9.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

public short select (short fid, 
byte [ ] fcp, 
short fcpOffset, 
short fcpLength) 
throws Java . lang . NullPointerException, 

Java .lang . Array I ndexOut Of Bounds Except ion, 
UICCException 
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5.1.1.9.1.1 Normal execution 

CRRNl: Selects a file of the UICC file system or of an ADF file system as defined in TS 102.221 [6]. 

CRRN2: The method returns the FCP information in a form of a TLV structure as specified in TS 102.221 [6]. 

CRRN3: If the fcpLength is greater than the length of the response, the whole response is copied into the fcp 
buffer and the length of the response is returned by the method. 

CRRN4: If the fcpLength is smaller than the length of the response, the first part of the response is copied into 
the fcp buffer and the fcpLength is returned by the method. 

CRRN5: After selecting an ADF/MF/DF no EF is selected. 

CRRN6: After selecting a linear fixed EF no record is selected. 

CRRN7: After selecting a cyclic EF the last updated record is the first record. 

CRRN8: Any file can be selected by FID which is an immediate child of the current directory. 

CRRN9: Any DF can be selected by FID which is an immediate child of the parent of the current DF. 

CRRNIO: The parent of the current directory can be selected by the FID. 

CRRNl 1: The ADF of the current active application can be selected by the FID. 

CRRN12: The ADF/MF can always be selected. 

CRRNl 3: The file context associated with the File View object is changed after successful execution. 

CRRN14: The current file context of any other applets shall not be changed. This will be tested during the 
testing of the framework. 

5.1.1.9.1.2 Parameter errors 

• CRRPl : If the array fcp is null, an instance of NullPointerException shall be thrown. 

• CRRP2: If fcpOffset is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

• CRRP3: If fcpLength is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

• CRRP4: If fcpOffset plus fcpLength is greater than the length of the array fcp. length an instance of 
ArraylndexOutOfBoundsException shall be thrown. 

5.1.1.9.1.3 Context errors 

• CRRCl: If the file with a File-ID which matches fid could not be found according to the selection rules, an 
instance of UICCException shall be thrown. The reason code shall be UICCException.FILE_NOT_FOUND. 

• CRRC2: If the method call causes a memory problem (e.g. memory access error), an instance of 
UICCException shall be thrown. The reason code shall be UICCException.MEMORY_PROBLEM. 

• CRRC3: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
SIMViewException shall be thrown. The reason code shall be UICCException.INTERNAL_ERROR. 

5.1.1.9.2 Test area files 

Test Source: Test_Api_l_Fvw_ Slctb_bss.java. 
Test Applet: Api_l_Fvw_ Slctb_bss _l.java. 

Cap File: api_l_fvw_ slctb_bss.cap. 
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5.1.1.9.3 



Test coverage 



CRR number 


Test case number 


N1 


1,2,3,4,5,6,7,8,14,18,20,21 


N2 


1,2,3,4,5,6,7,8,14,18,20,21 


N3 


1 


N4 


2, 3, 4 ,5, 6, 7,8 


N5 


15,19 


N6 


17 


N7 


18 


N8 


14 


N9 


14 


N10 


14 


N11 


19,20 


N12 


20 


N13 


20 


N14 


1,2,3,4,5,6,7,8,14,18,20 


P1 


9 


P2 


10 


P3 


11 


P4 


12, 13 


C1 


16 


C2 


Not testable 


C3 


Not testable 



5.1.1.9.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Get a FileView object, UICC file system 

get a FileView 

FileView. getTheUICCView(CLEAR_ON_RESET) 






1 


Select EFtaru in MF (Transparent EF) 

Select DFtest 

select EFtaru, 

fid=6F03 

byte[] fcp = new byte[132] 

fcpOffset = 

fcpLength = 127 


Shall return at least 19. 

fcp[] shall contain following TLVs: 

1.82 02 41 21 //file descriptor 

2. 83 02 2F E2 //file id 

3. 8A 01 05 //life cycle status 

4. 80 02 00 OA // file size 




2 


Select EFtaru in MF (Transparent EF) 

select EFtsru, 
fid=6F03 
fcpOffset = 
fcpLength = 7 
select 


Shall return 7. 

fcp[] shall contain the first 7 bytes of 

the FCP structure and contain 

following TLV. 

1.82 02 41 21 //file descriptor 




3 


Select DFtest in MF 

fid = DFtest, fid=llll 
fcpOffset = 
fcpLength = 127 
select 


Shall return at least 17. 

fcp[] shall contain following TLVs 

1.82 02 78 21 //file descriptor 

2. 83 02 1 1 11 //file id 

3. 8A 01 05 //life cycle status 




4 


Select EFcaru in DFtest (Cyclic EF) 

select EFcARo, 
fid=6f09 
fcpOffset = 
fcpLength = 11 
select 


Shall return: 1 1 

fcp[] shall contain following TLV: 

82 05 46 21 00 03 02 
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Id 


Description 


API Expectation 


APDU Expectation 


5 


Select ADF1 

select ADF 

fid=7FFF 

fcp[0:5]=0x00 

fcpOffset=5 

fcpLength=127 

select 


Shall return: at least 27 
The first 5 bytes of fcp[] shall be 0x00 
and contains following TLVs: 
1.82 02 78 21 //file descriptor 

2. 84 10 AO 00 00 00 09 00 05 FF FF 
FF FF 89 60 00 00 00 //DF Name 

3. 8A 01 05 //life cycle 




6 


Select MF 

select MF, 
fid= 3F00 
fcpOffset = 
fcpLength = 11 
select {) 


Shall return: 11 

fcp[] shall contain following TLVs: 

1 . 82 02 38/78 21 //file descriptor 

2. 83 02 3F 00 //file ID 




7 


Select DFtelecom in MF 

select DFtelecom, 

fid=7F10 

fcp[0] = fcp[l] = 0x05 

fcpOffset = 2 

fcpLength = 13 

select 


Shall return 13. 

The first 2 bytes of fcp[] shall be 0x05 

and fcp[] shall contain following TLVs 

1 . 82 02 38/78 21 //file descriptor 

2. 83 02 7F 1 //file id 




8 


Select EFlaru in DFtelecom (Linear FixedEF) 

select EFlaru, 
fid = 6F0C 
fcpOffset = 
fcpLength =14 


Shall return 14. 

fcp[] shall contain following TLVs: 

1.82 05 42 21 00 04 02 

2. 83 02 6F OC 




9 


fcp is null 

select EFlsro, 

fid = 6F0C 

byte [ ] nullBuffer = null 

fcpOffset = 

fcpLength = 15 


Shall throw 
java.lang.NullPointerException 




10 


fcpOffset < 

select EFlaru, 
fid = 6F0C 
fcpOffset = -1 
fcpLength = 15 


Shall throw 

java.lang.ArraylndexOutOfBoundsExce 

ption 




11 


fcpLength < 

select EFlarl, 
fid = 6F0C 
fcpOffset = 
fcpLength = -1 


Shall throw 

java.lang.ArraylndexOutOfBoundsExce 

ption 




12 


fcpOffset + fcpLength > fcp.length 

select EFlaru, 
fid = 6F0C 
fcpOffset = 115 
fcpLength =18 


Shall throw 

java.lang.ArraylndexOutOfBoundsExce 

ption 




13 


fcpOffset + fcpLength > fcp.length 

select EFlaru, 

fid = 6F0C 

fcpOffset = fcpLength + 1 

fcpLength = 


Shall throw 

java.lang.ArraylndexOutOfBoundsExce 

ption 
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Id 


Description 


API Expectation 


APDU Expectation 


14 


Selection possibilities 

0- select MF, fid=3F00 

1- select EFoicc, fid=2FF0 

2- select DFiest, fid=llll 

3- select EFcno, fid=6F05 

4- select EFisaa, fid=6F16 

5- select DFsobjest, fid=2211 

6- select DFiest, fid=llll 

7- select EFisba, fid=6F16 

8- select DFiest, fid=llll 

9- select MF, fid=3F00 

10- select DFiest, fid=llll 

11- select EFiasA, fid=6F16 

12- select MF, fid=3F00 


No exception shall be thrown. 




15 


EF not selected after MF/DF selection 

1- select MF, 
fid = 3F00 
select EFicciD, 
fid = 2FE2 
2 - select MF 
fid = 3F00 
select {) 
readBinary ( ) 


2 - Shall throw 

uicc.access.UICCException with 
reason code NO_EF_SELECTED. 




16 


No selection of non-reachable file 

1 - select MF, 
fid = 3F00 

2 - select EFcaro, 
fid= 0x6F09 


2 - Shall throw 

uicc.access.UICCException with 
reason code FILE_NOT_FOUND. 




17 


No record is selected after selecting linear 
fixed EF 

1- select MF, 
fid = 3F00 

2- select DFiest, 
fid=llll 

3- select EFiaRo, 
fid=6F0C 

4 - recNumber = 

mode = REC„ACC_MODE_ CURRENT 

readRecord {) 


4 - Shall throw uicc.access.UICC 
Exception with reason code 
RECORD NOT FOUND. 




18 


Record pointer in selected cyclic EF 

1- select MF, 
fid = 3F00 

2- select DFiest, 
fid=llll 

3- select EFcaro, 
fid=6F09 

4- byte[] datal = { 1,2,3 } 
mode = REC_ACC_MODE_PREVIOUS 
updateRecord (datal ) 

5- select EFcaro 
fid = 6F09 
select 

mode = REC_ACC_MODE_PREVIOUS 
readRecord ( ) 
readRecord {data2 ) 
compare datal to data2 

6- restore original data of EFcaro 


5 - The contents of datal and data2 
shall be identical. 




19 


EF not selected after ADF/DF selection 

1- get a FileView 

UlCCSystem . getTheFileView (AID_ADF1 , CLEAR 
_0N_RESET) 

2- select ADF, 
fid = 7FFF 
select EFoicc, 
fid = 2FF0 

3 - select ADF 
fid = 7FFF 
select 
readBinary {) 


3 - Shall throw 

uicc.access.UICCException with 
reason code NO_EF_SELECTED. 





ETSI 



Release 6 



75 



ETSI TS 102 268 V6.0.0 (2007-03) 



Id 


Description 


API Expectation 


APDU Expectation 


20 


Reselection 

1- Using the ADF FileView 
select ADF, fid=7FFF 
select ADF, fid=7FFF 

2- Using the UICC FileView 
select MF, fid=3F00 
select MF, fid=3F00 

3- select DFiest, fid=llll 
select DFiest, fid=llll 

5- select EFiaaa, fid=6F16 
select EFiaaa, fid=6F16 


No exceptions shall be thrown 




21 


Security attributes 

1- Using the ADF FileView 
select ADF, fid=7FFF 
select DFiest, fid=llll 
select EFlarri, fid=6FAl 

2- Using the UICC FileView 
select MF, fid=3F00 
select DFiest, fid=llll 
select EFiARRB, fid=6FB3 


1- fcp[] shall contain the following TLV 
8B 03 AC 00 01 or 

8B 06 AC 00 00 01 01 01 

2- fcp[] shall contain the following TLV 
8B 03 AC 00 03 or 

SB 06 AC 00 00 03 01 03 





5.1.1.10 Method status 

Test Area Reference: Api_l_Fvw_Stat. 



5.1.1.10.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

public short status (byte [ ] fcp, 

short fcpOffset, 
short fcpLength) 
throws Java . lang . NullPointerException, 

Java. lang. ArraylndexOutOfBoundsException, 
UICCException 



5.1.1.10.1.1 



Normal execution 



• CRRNl : The method returns the File Control Parameter of the current selected DF/MF or ADF as defined in 
TS 102 221. 

• CRRN2: If the fcpLength is greater than the length of the response, the whole response is copied into the 
fcp buffer and the length of the response is returned by the method. 

• CRRN3: f the f cplength is smaller than the length of the response, the first part of the response is copied 
into the fcp buffer and the fcpLength is returned by the method. 

5.1.1.10.1.2 Parameter errors 

• CRRPl : If the array fcp is null, an instance of NullPointerException shall be thrown. 

• CRRP2: If fcpOffset is negative, an instance of ArraylndexOutOfBoundsException shall be thrown. 

• CRRP3: If fcpLength is negative, an instance of ArraylndexOutOfBoundsException shall be thrown. 

• CRRP4: If fcpOffset+fcpLength is greater than fcp. length an ArraylndexOutOfBoundsException shall be 
thrown. 



5.1.1.10.1.3 



Context errors 



CRRCl: If the method call causes a memory problem (e.g. memory access error), an instance of 
UICCException shall be thrown. The reason code shall be UICCException.MEMORY_PROBLEM 
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• CRRC2: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
UICCException shall be thrown. The reason code shall be UICCException.INTERNAL_ERROR 



5.1.1.10.2 

Test Source: 
Test Applet: 
Cap File: 

5.1.1.10.3 



Test area files 

Test_ Api_l_Fvw_Stat.java. 
Api_l_Fvw_Stat_l .Java. 
Api_l_Fvw_Stat.cap. 

Test coverage 



CRR number 


Test case number 


N1 


1,2,3,4,5,11 


N2 


2,3 


N3 


1,4 


P1 


6 


P2 


7 


P3 


8 


P4 


9,10 


C1 


Not testable 


C2 


Not testable 



5.1.1.10.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Status of MF 

1- Get a FlleVlew object, UICC file get 
a FlleVlew 

FlleVlew. getTheUICCVlew(CLEAR_ON_RESET) 

2- select MF 

byte[] fcp = new byte[127] 
fcp[0:2]= OxCC 
fcpOffset = 3 
fcpLength = 11 
status 


2- Shall return 11. 

The first 3 bytes of fcp[] shall contain 

OxCC. 

fcp[] shall contain following TLVs: 

1 . 82 02 38/78 21 //file descriptor 

2. 83 02 3F 00 //file ID 




2 


Status after select EFtaru in MF 

1 - select DFtest 
select EFtaru, fid = 6F03 
fcpOffset = 
fcpLength =12 7 
select 
status 


1- Shall return at least 19. 
fcp[] shall contain following TLVs: 
1 . 82 02 38/78 21 //file descriptor 
2.83 02 11 11 //file ID 




3 


Status of DFtelecom 

1 - fid = 7F10 
fcpOffset = 
fcpLength = 127 
status 


1 - 

Shall return at least 17 and the entire 
structure of the file control parameters. 
The file identifier shall be contain the 
fid of DFtelecom- 




4 


Status DFtelecom 

Select DFiELEcoK, fid=7F10 
fcpOffset = 
fcpLength = 11 
status 


Shall return 1 1 . 

fcp shall contain the first 1 1 bytes of 
the FCP structure starting at index 0. 
fcp[] shall contain following TLVs: 

1 . 82 02 38/78 21 //file descriptor 

2. 83 02 7F 1 //file id 
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Id 


Description 


API Expectation 


APDU Expectation 


5 


Status ADF1 

select ADF, fid=7FFF 
fcpOffset = 
fcpLength = 127 


Shall return at least 27 

fcp[] shall contain the entire FCP 

structure 

fcp[] shall contain following TLVs: 

1.82 02 78 21 //file descriptor 

2. 84 10 AG 00 00 00 09 00 05 FF FF 
FF FF 89 60 00 00 00 //DF Name 

3. 8A 01 05 //life cycle 




6 


fcp is null 

byte[] nullBuffer = null 
fcpOffset = 
fcpLength = 34 
status 


Shall throw 
java.lang.NullPointerException. 




7 


fcpOffset < 

fcpOffset = -1 
fcpLength = 34 
status 


Shall throw 

java.lang.ArraylndexOutOfBoundsExce 

ption. 




8 


fcpLength < 

fcpOffset = 
fcpLength = -1 
status 


Shall throw 

java.lang.ArraylndexOutOfBoundsExce 

ption. 




9 


fcpOffset + fcpLength > fcp.length 

fcpOffset = fcp.length-1 
fcpLength = 15 
status 


Shall throw 

java.lang.ArraylndexOutOfBoundsExce 

ption. 




10 


fcpOffset + fcpLength > fcp.length 

fcpOffset = fcp.length+1 
fcpLength = 
status 


Shall throw 

java.lang.ArraylndexOutOfBoundsExce 

ption. 




11 


Security attributes 

1- Using the ADF FileView 
select ADF, fid=7FFF 
select DFtest, 

select DFbre2, 

2- Using the UICC FileView 
select MF, fid=3F00 
select DFtest, 

select DFjEHi, 


1- fcp[] shall contain the following TLV 
8B 03 AC 00 02 or 

8B 06 AC 00 00 02 01 02 

2- fcp[] shall contain the following TLV 
8B 03 AC 00 04 or 

8B 06 AC 00 00 04 01 04 





5.1 .1 .11 Method updateBinary 

Test Area Reference: Api_l_Fvw_Updb. 



5.1.1.11.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

public void updateBinary (short fileOffset, 

byte [ ] data, 
short dataOffset, 
short dataLength) 
throws Java . lang . NullPointerException, 

Java .lang . Array I ndexOut Of Bounds Except ion, 
UICCException 

5.1.1.11.1.1 Normal execution 

• CRRNl : Updated the data bytes of the current selected transparent EF. 
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5.1.1.11.1.2 



Parameter errors 



CRRPl: If recOffset is less than 0, an instance of UICCException sliall be tlirown. The reason code shall be 
UICCException.OUT_OF_FILE .BOUNDARIES. 

CRRP2: : If fileOffset plus dataLength exceeds the length of the file, an instance of UICCException shall be 
thrown. The reason code shall be UICCException.OUT_OF_FILE .BOUNDARIES 

CRRP3: If the array data is null, an instance of NuUPointerException shall be thrown. 

CRRP4: If dataOffset is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

CRRP5: If dataLength is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

CRRP6: If dataOffset plus dataLength greater than the length of the array data.length an instance of 
ArraylndexOutOfBoundsException shall be thrown. 



5.1.1.11.1.3 



Context errors 



CRRCl : If the calling applet has currently no EF selected, an instance of UICCException shall be thrown. The 
reason code shall be UICCException.NO_EF_SELECTED. 

CRRC2: If the currently selected EF is not transparent, an instance of UICCException shall be thrown. The 
reason code shall be UICCException. COMMANDJNCOMPATIBLE. 

CRRC3: If the calling applet does not fulfil the access condition, UPDATE, to perform this function, an 
instance of UICCException shall be thrown. The reason code shall be UICCException. 

SECURITY_STATUS_NOT_SATISFIED. 

CRRC4: If the currently selected EF is deactivated and the file status of the EF does not allow for updating of 
a deactivated file, an instance of UICCException shall be thrown. The reason code shall be UICCException. 

REF_DATA_INVALIDATED. 

CRRC5: If the method call causes a memory problem (e.g. memory access error), an instance of 
UICCException shall be thrown. The reason code shall be UICCException.MEMORY_PROBLEM. 

CRRC6: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
UICCException shall be thrown. The reason code shall be UICCException.INTERNAL_ERROR. 



5.1.1.11.2 

Test Source: 
Test Applet: 
Cap File: 

5.1.1.11.3 



Test area files 

Te s t_ Api_ 1 _Fv w_Updb .j a va . 
Api_l_Fvw_Updb _Ljava. 
api_ 1 _fvw_updb .cap. 

Test coverage 



CRR number 


Test case number 


N1 


2,3 


PI 


4 


P2 


5 


P3 


6 


P4 


7 


P5 


8 


P6 


9 


CI 


1 


C2 


10 


C3 


11 


C4 


12 


C5, 


Not Testable 


C6 


Not Testable 
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5.1.1.11.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Get the UICC FlleVlew 

FileView.getTheUICCView(CLEAR_ON_RESET) 







1 


No EF selected 

fileOffset = 
byte[] data = new byte [20] 
data[0] = '55' 
dataOffset = 
dataLength = 10 
updateBinary () 


Shall throw uicc.access.UICC 
Exception with reason code 
NO_EF_SELECTED. 


1 


2 


Update Transparent EF 

1- select DFiEST, fid = 1111 

2- select EFisro, fid = 6F03 

3- fileOffset = 3 
data[0] = '55' 
dataOffset = 
dataLength = 1 
updateBinary () 

4- fileOffset = 3 
respOffset = 
respLength = 1 
readBinary () 


1- No exception shall be thrown. 

2- No exception shall be thrown. 

3- No exception shall be thrown. 

4- No exception shall be thrown. 
Data in resp[0] shall be '55'. 




3 


fileOffset = 254 

1- fileOffset = 254 
data[0] = '55' 
data[l] = 'AA' 
data[2] = '66' 
dataOffset = 
dataLength = 3 
updateBinary ( ) 

2- fileOffset = 254 
respOffset = 
respLength = 3 
readBinary () 


1- No exception shall be thrown. 

2- No exception shall be thrown. 
Data in resp shall be 

resp[0] = '55' 
resp[1 ] = 'AA' 
resp[2] = '66' 




4 


Offset into File out of bounds 

fileOffset = -1 
dataOffset = 
dataLength = 10 
updateBinary () 


Shall throw 

uicc.access.UICCException with 
reason code 
OUT OF FILE BOUNDARIES. 




5 


fileOffset + dataLength > EF length 

fileOffset = 259 
dataOffset = 
dataLength = 2 
updateBinary () 


Shall throw uicc.access.UICC 
Exception with reason code 
OUT_OF_FILE_BOUNDARIES. 




6 


data is null 

byte [ ] nullBuffer = null 
fileOffset = 
dataOffset = 
dataLength = 10 
updateBinary () 


Shall throw 
java.lang.NullPointerException. 




7 


dataOffset < 

fileOffset = 
dataOffset = -1 
dataLength = 10 
updateBinary () 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsException. 




8 


dataLength < 

fileOffset = 
dataOffset = 
dataLength = -1 
updateBinary () 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsException. 




9 


dataOffset + dataLength > data.length 

fileOffset = 
dataOffset = 10 
dataLength =11 
updateBinary () 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsException. 




10 


EF is not Transparent 

1- select DFiEST, fid = 1111 

2- select DFlaru, fid = 6F0C 
3 - fileOffset = 
data[0] = '55' 
dataOffset = 
dataLength = 1 
updateBinary () 


1- No exception shall be thrown. 

2- No exception shall be thrown. 

3- Shall throw uicc.access.UICC 
Exception with reason code 
COMMANDJNCOMPATIBLE. 
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Id 


Description 


API Expectation 


APDU Expectation 


11 


Access condition not fulfilled 

1- select DFiEST, fid = 1111 

2- select EFtnu, fid = 6F02 

3- fileOffset = 
data[0] = '55' 
dataOffset = 
dataLength = 1 
updateBinary () 


1- No exception shall be thrown. 

2- No exception shall be thrown. 

3- Shall throw 

uicc. access. UlCCException with 

reason code 

SECURITY STATUS NOT SATISFIE 

D. 




12 


EF is deactivated 

1- select EFiNR, fid = 6F01 
deactiveFile () 

2- fileOffset = 
data[0] = '55' 
dataOffset = 
dataLength = 1 
updateBinary () 

3- activateFile 


1- No exception shall be thrown. 

2- Shall throw 

uicc. access. UlCCException with 
reason code 
REF_DATA_INVALIDATED 

3- No exception shall be thrown. 





5.1.1.12 Method updateRecord 

Test Area Reference: Api_l_Fvw_Updr. 



5.1.1.12.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

public void updateRecord (short recNumber, 

byte mode, 
short recOffset, 
byte [ ] data, 
short dataOffset, 
short dataLength) 
throws Java . lang.NullPointerException, 

Java . lang . Array I ndexOut Of Bounds Except ion, 
UlCCException 

5.1.1.12.1.1 Normal execution 

• CRRNl: Reads a record or a part of record of the current linear fixed or cyclic EF into byte array data[]. 

• CRRN2: If the access mode is REC_ACC_MODE_ CURRENT the current selected record will be updated. 
The current record pointer shall not be changed. 

• CRRN3:If the access mode is REC_ACC_MODE_ ABSOLUTE and the file is linear fixed EF, the record 
addresss by recNumber will be updated. The current record pointer shall not be changed. 

• CRRN4: If the access mode is REC_ACC_MODE_NEXT and the file is a linear fixed EF the next record 
relative to the current selected record will be selected and updated. The record pointer shall be updated. 

• CRRN5: If the access mode is REC_ACC_MODE_NEXT and the record pointer has not been previously set 
within the selected EF, the record pointer shall be set to the first record and this record should be updated. 

• CRRN6: If the access mode is REC_ACC_MODE_PREVIOUS the previous record relative to the current 
selected record will be selected and updated. The record pointer shall be updated. 

• CRRN7: If the access mode is REC_ACC_MODE_PREVIOUS and the record pointer has not been previously 
set within the selected EF, then the record pointer should be set to the last record in this EF. This record should 
be updated. 

• CRRN8: If the access mode is REC_ACC_MODE_PREVIOUS, the file is a cyclic EF, the oldest record will 
be updated independent of the current record pointer and this record becomes record number 1 and the current 
record. 
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5.1.1.12.1.2 Parameter errors 

• CRRPl : If the currently selected EF is linear fixed and the access mode is REC_ACC_MODE_ABSOLUTE 
and recNumber is less than or greater than records available, an instance of UICCException shall be thrown. 
The reason code shall be UICCException.RECORD_NOT_FOUND. 

• CRRP2: If the currently selected EF is Unear fixed and the access mode is REC_ACC_MODE .CURRENT, 
recNumber is and there is no current record selected, an instance of UICCException shall be thrown. The 
reason code shall be UICCException. RECORD_NOT_FOUND. 

• CRRP3: If the currently selected EF is linear fixed and the access mode is REC_ACC_MODE_NEXT and the 
current record pointer is set to the last record, an instance of UICCException shall be thrown. The reason code 
shall be UICCException. RECORD_NOT_FOUND. 

• CRRP4: If the currently selected EF is hnear fixed and the access mode is REC_ACC_MODE_PREVIOUS 
and the current record pointer is set to the first record; an instance of UICCException shall be thrown. The 
reason code shall be UICCException. RECORD_NOT_FOUND. 

• CRRP5: If the specified offset into the selected record recOffset is less than 0, an instance of UICCException 
shall be thrown. The reason code shall be UICCException.OUT_OF_RECORD_BOUND ARIES. 

• CRRP6: If recOffset plus dataLength is greater than the record length, an instance of UICCException shall be 
thrown. The reason code shall be UICCException.OUT_OF_RECORD_BOUND ARIES. 

• CRRP7: If the access mode is not between 2 and 4 inclusive (2 = REC_ACC_MODE_NEXT, etc.), an 
instance of UICCException shall be thrown. The reason code shall be UICCException.INVALID_MODE. 

• CRRP8: If the currently selected EF is cyclic and the mode of record access mode is not 
REC_ACC_MODE_PREVIOUS, an instance of UICCException shall be thrown. The reason code shall be 
UICCException.INVALID_MODE or UICCException.COMMAND_INCOMPATIBLE . 

• CRRP9: If the array data is null, an instance of NuUPointerException shall be thrown. 

• CRRPIO: If dataOffset is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

• CRRPl 1 : If dataLength is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

• CRRP12: If dataOffset plus dataLength, is greater than the length of the array data.length, or dataOffset equals 
data.length, an instance of ArraylndexOutOfBoundsException shall be thrown. 

5.1.1.12.1.3 Context errors 

• CRRCl : If the calling applet has currently no EF selected, an instance of UICCException shall be thrown. The 
reason code shall be UICCException.NO_EF_SELECTED. 

• CRRC2: If the currently selected EF is neither linear fixed nor cyclic, an instance of UICCException shall be 
thrown. The reason code shall be UICCException.COMMANDJNCOMPATIBLE. 

• CRRC3: If the calling applet does not fulfil the access condition, UPDATE, to perform this function, an 
instance of UICCException shall be thrown. The reason code shall be UICCException. 
SECURITY_STATUS_NOT_SATISFIED. 

• CRRC4: If the currently selected EF is deactivated and the file status of the EF does not allow for updating an 
deactivated file, an instance of UICCException shall be thrown. The reason code shall be UICCException. 
REF_DATA_INVALIDATED. 

• CRRC5: If the method call causes a memory problem (e.g. memory access error), an instance of 
UICCException shall be thrown. The reason code shall be UICCException.MEMORY_PROBLEM. 

• CRRC6: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
UICCException shall be thrown. The reason code shall be UICCException.INTERNAL_ERROR. 
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5.1.1.12.2 

Test Source: 
Test Applet: 
Cap File: 

5.1.1.12.3 



Test area files 

Test_Api_l_Fvw_Updr.java. 
Api_ 1 _Fvw_ Updr_ 1 .j ava. 
api_ 1 _fvw_updr.cap . 

Test coverage 



CRR number 


Test case number 


N1 


2,3,4,5,7,8, 10 


N2 


2 


N3 


3 


N4 


5 


N5 


4 


N6 


7,8,9, 10 


N7 


7 


N8 


10 


P1 


11 


P2 


12 


P3 


6 


P4 


9 


P5 


13 


P6 


14 


P7 


15 


P8 


16 


P9 


17 


P10 


18 


P11 


19 


P12 


20 


C1 


1 


C2 


21 


C3 


22 


C4 


23 


C5 


Not testable 


C6 


Not testable 
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5.1.1.12.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Get the UICC FileView 

FileView.getTheUICCView(CLEAR_ON_RESET) 






1 


No EF selected 

RecNumber = 1 

mode = REC_ACC_MODE_ABSOLUTE 

recOffset = 

byte[] data = new byte [20] 

dataOffset = 

dataLength = 10 

updateRecord ( ) 


Shall throw uicc.access.UICC Exception 
with reason code NO_EF_SELECTED. 




2 


Update Absolute from Linear Fixed EF 

1- select DFtest, fid = 1111 

2- select EFibru, fid = 6F0C 
// Record pointer not set. 

3- recNumber = 2 

mode = REC_ACC_M0DE_ABS0LUTE 

data [0:3] = '11' 

recOffset = 

dataOffset = 

dataLength = 4 

updateRecord ( ) 

respOffset = 

respLength = 

readRecord ( ) 

4- // verify result 
read respOffset = 
respLength = 4 
recNumber = 

mode = REC_ACC_MODE_CURRENT 
readRecord ( ) 


1- No exception shall be thrown. 

2- No exception shall be thrown. 

3- No exception shall be thrown. 
4-Respshallbe:11 111111 




3 


Update Current from Linear Fixed EF 

1- select DFtest, fid = 1111 

2- select EFmro, fid = 6F0C 

// Set record pointer with mode "next". 

3- recNumber = 

mode = REC_ACC_MODE_NEXT 

recOffset = 

data[0:3] = '00' 

dataOffset = 

dataLength = 4 

updateRecord ( ) 

// write data with mode "current" 

4- recNumber = 
data[0:3] = '22' 

mode = REC_ACC_MODECURRENT 
updateRecord ( ) 

5- //verify result 
respOffset = 
respLength = 4 
recNumber = 

mode = REC_ACC_MODE_ CURRENT 
readRecord ( ) 


1- No exception shall be thrown. 

2- No exception shall be thrown. 

3- No exception shall be thrown. 

5- No exception shall be thrown. 

resp shall be: 

resp[0] = '22' 

resp[1] = '22' 

resp[2] = '22' 

resp[3] = '22' 




4 


Update Next from Linear Fixed EF, no 
record pointer set 

1- select DFtest, fid = 1111 

2- select EFibru, fid = 6F0C 

3- recNumber = 

mode = REC_ACC_MODE_NEXT 

recOffset = 

data[0:3] = '33' 

dataOffset = respOffset = 

dataLength = respLength = 4 

updateRecord () 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 

4-// verify result 

readRecord ( ) 


1- No exception shall be thrown. 

2- No exception shall be thrown. 

4- No exception shall be thrown. 

resp shall be: 

resp[0] = '33' 

resp[1] = '33' 

resp[2] = '33' 

resp[3] = '33' 
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Id 


Description 


API Expectation 


APDU Expectation 


5 


Update Next from Linear Fixed EF, record 








pointer set 


1- No exception shall be thrown. 






1- recNumber = 








mode = REC_ACC_MODE_NEXT 








recOffset = 








data[0:3] = '44' 
dataOffset = 


2- No exception shall be thrown. 






dataLength = 4 


resp shall be: 






updateRecord ( ) 


resp[0] = '44' 






2- //verify result 


resp[1 ] = '44' 






readRecord ( ) 


resp[2] = '44' 
resp[3] = '44' 




6 


Update Next from Linear Fixed EF, no more 
records 








recNumber = 


Shall throw uicc.access.UICCException 






mode = REC_ACC_MODE_NEXT 


with reason code 






recOffset = 


RECORD_NOT_FOUND. 






data[0:3] = '55' 








dataOffset = 








dataLength = 4 








updateRecord ( ) 






7 


Update Previous from Linear Fixed EF, no 
record pointer set 








1- select DFtesi, fid = 1111 


1- No exception shall be thrown. 






2- select EFisro, fid = 6F0C 


2- No exception shall be thrown. 






3- recNumber = 


3- No exception shall be thrown. 






mode = REC_ACC_MODE_PREVIOUS 








recOffset = 








data[0:31 = '66' 








dataOffset = respOffset = 








dataLength = respLength = 4 


4- No exception shall be thrown. 






updateRecord ( ) 


resp shall be: 






4- //verify result 


resp[0] = '66' 






readRecord ( ) 


resp[1] = '66' 
resp[2] = '66' 
resp[3] = '66' 




8 


Update Previous from Linear Fixed EF, 
record pointer set 








1- recNumber = 


1 - No exception shall be thrown 






mode = REC_ACC_MODE_PREVIOUS 








recOffset = 
data[0:3] = '77' 
dataOffset = respOffset = 


2- No exception shall be thrown, 
esp shall be: 






dataLength = respLength = 4 


resp[0] = '77' 






updateRecord ( ) 


resp[1] = '77' 






2- //verify result 


resp[2] = '77' 






readRecord ( ) 


resp[3] = '77' 




9 


Update Previous from Linear Fixed EF , no 
more records 








recNumber = 


Shall throw 






mode = REC_ACC_MODE_PREVIOUS 


sim. access. SIIVIViewException with 






recOffset = 


reason code RECORD_NOT_FOUND. 






data [0:3] = '88' 








dataOffset = respOffset = 








dataLength = respLength = 4 
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Id 


Description 


API Expectation 


APDU Expectation 


10 


Update Previous from Cyclic EF 

1- select DFtesi, fid = 1111 

2- select EFcaru, fid = 6F09 

3- recNumber = 2 

mode = REC_ACC_MODE_ABSOLUTE 
recOffset = 
respOffset = 
respLength = 3 
readRecord ( ) 

4- recNumber = 2 

mode = REC_ACC_MODE_PREVIOUS 
data [0:2] = 'FF' 
dataOffset = 
dataLength = 3 
updateRecord ( ) 

5- //verify result 
readRecord ( ) 


1- No exception shall be thrown. 

2- No exception shall be thrown. 

3- No exception shall be thrown. 

4- No exception shall be thrown. 

5- No exception shall be thrown, 
resp shall be: 

resp[0] = 'FF'resp[1] = 'FF' 
resp[21 = 'FF' 




11 


Update Absolute from Linear Fixed EF 
beyond Records 

1- select EFisEo, fid = 6F0C 

2-recNumber = -1 

mode = REC_ACC__MODE_ABSOLUTE 

recOffset = 

dataOffset = 

dataLength = 4 

updateRecord ( ) 

3- recNumber = 3 

updateRecord ( ) 


1- No exception shall be thrown. 

2- Shall throw 

uicc.access.UICCException with reason 
code RECORD NOT FOUND. 

3- Shall throw 

uicc.access.UICCException with reason 
code RECORD_NOT_FOUND. 




12 


No current record in linear fixed EF, update 
current 

1- select EFisEo, fid = 6F0C 
// No curr rec 

2- recNumber =0 // curr rec 
mode = REC_ACC_MODE _CURRENT 
recOffset = 

dataOffset = 
dataLength = 4 
updateRecord ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

uicc.access.UICCException with reason 
code RECORD_NOT_FOUND. 




13 


recOffset < 

1- select EFiAEo, fid = 6F0C 

2- recNumber =1 // rec 1 
mode = REC_ACC_MODE_ABSOLUTE 
dataOffset = 
dataLength = 4 
updateRecord ( ) 


1- No exception shall be thrown. 

2- Shall throw uicc.access.UICC 
Exception with reason code 
OUT_OF_RECORD_BOUNDARIES. 




14 


recOffset + dataLength > record.length 

1- select EFiaRu, fid = 6F0C 

2- recNumber = 1 

mode = REC_ACC_MODE_ABSOLUTE 
recOffset = 2 
dataOffset = 
dataLength = 4 
updateRecord ( ) 


1- No exception shall be thrown. 

2- Shall throw uicc.access.UICC 
Exception with reason code 
OUT_OF_RECORD_BOUNDARIES. 




15 


Updating with invalid mode 

1- select EFisEo, fid = 6F0C 

2- recNumber = 
mode = 1 
recOffset = 
dataOffset = 
dataLength = 4 
updateRecord ( ) 

3- mode = 5 
updateRecord ( ) 


1 - No exception shall be thrown. 

2 - Shall throw uicc.access.UICC 
Exception with reason code 
INVALID_MODE. 

3 - Shall throw uicc.access. UICC 
Exception with reason code 
INVALID MODE. 
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Id 


Description 


API Expectation 


APDU Expectation 


16 


Updating Cyclic EF with invalid mode 

1- select DFtesi, fid = 1111 

2- select EFcaru, fid = 6F09 

set record pointer to record nr 1 

3- recNumber = 

mode = REC_ACC_MODE_NEXT 
recOffset = 
data[0:2] = '00' 
dataOffset = 
dataLength = 3 
updateRecord ( ) 

4- recNumber = 

mode = REC_ACC_MODE_CURRENT 
updateRecord ( ) 

5- recNumber = 2 

mode = REC_ACC_MODE_ABSOLUTE 
updateRecord ( ) 

6- recNumber = 
mode = 5 
updateRecord ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - Shall throw uicc.access. UICC 
Exception with reason code 
INVALID MODE or 
COMMANDJNCOMPATIBLE. 

4 - Shall throw uicc.access. UICC 
Exception with reason code 
INVALID MODE or 
COMMANDJNCOMPATIBLE. 

5 - Shall throw uicc.access. UICC 
Exception with reason code 
INVALID MODE or 
COMMANDJNCOMPATIBLE. 

6 - Shall throw uicc.access. UICC 
Exception with reason code 
INVALID MODE or 
COMMAND INCOMPATIBLE. 




17 


data[] is null 

data [ ] = null 
dataOffset = 
dataLength = 10 
updateRecord ( ) 


Shall throw 
java.lang.NullPointerException. 




18 


dataOffset < 

dataOffset = -1 
dataLength = 10 
updateRecord ( ) 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsException. 




19 


dataLength < 

dataOffset = 
dataLength = -1 
updateRecord () 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsException. 




20 


dataOffset + dataLength > data.length 

dataOffset = 10 
dataLength = 11 
updateRecord ( ) 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsException. 




21 


EF is neither Cyclic nor Linear Fixed 

1- select DFtesi, fid = 1111 

2- select EFtnr, fid = 6F01 

3- dataOffset = 
dataLength = 4 
updateRecord ( ) 


1- No exception shall be thrown. 

2- No exception shall be thrown. 

3- Shall throw uii. access. UICC 
Exception with reason code 
COMMAND INCOMPATIBLE. 




22 


Access condition not fulfilled 

1- select EFcNo, fid = 6F05 

2- recOffset = 
dataOffset = 
dataLength = 1 

mode = REC_ACC_MODE_PREVIOUS 
updateRecord ( ) 

3- fid = EFLNU 
select ( ) 

4- recNumber = 1 

mode = REC_ACC_MODE„ CURRENT 
recOffset = 
dataOffset = 
dataLength = 1 
updateRecord ( ) 


1- No exception shall be thrown. 

2- Shall throw uicc.access. UICC 
Exception with reason code 
SECURITY STATUS NOT SATISFIE 
D. 

3- No exception shall be thrown. 

4- Shall throw uicc.access. UICC 
Exception with reason code 
SECURITY STATUS NOT SATISFIE 
D 
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Id 


Description 


API Expectation 


APDU Expectation 


23 


EF is deactivated 

1- select EFcNR, fid = 6F04 
invalidate ( ) 

2- updateRecord ( ) 

3- activateFile () 

4- restore the file content EFiaro, EFcsru 


1- No exception shall be thrown. 

2- Shall throw 

uicc.access.UICCException with reason 
codeREF_DATA_INVALIDATED 

3- No exception shall be thrown. 




24 


Restore the file content 

1- restore the file content of EFisro: 
record 1 = 0x55,0x55,0x55,0x55 
record 2 = OxAA, OxAA, OxAA, OxAA 

2- restore the file content of EFcari : 
record 1 = 0x55,0x55,0x55,0x55 
record 2 = OxAA, OxAA, OxAA, OxAA 







5.1.2 Interface U I CCConstants 

This interface hold all the constants defined in TS 102 221 [6]. No test of constants will be performed. 

5.1.3 Interface U I CCSystem 
5.1 .3.1 Method getTheUICCView 

Test Area Reference: Api_l_Usy_Getfb. 

5.1 .3.1 .1 Conformance requirement: 

The method with following header shall compliant to its definition in the API. 

public static FileView getTheUICCView (byte event) 

throws javacard. framework . SystemException 

5.1.3.1.1.1 Normal execution 

CRRNl: returns a reference to class which implements the FileView interface on the UICC file system. 

CRRN2: return null if one of the javacard.framework. Applet. register(..) method has not previously invoked by 
the applet invoking this method or the file system server returns null. 

CRRN3: It is not possible to get access to files which are located under any ADF with this FileView. 

CRRN4: After a successful invocation of the method, the MF is the current selected file. 

CRRN5: A separate and independent file context shall be associated with each and every FileView object: the 
operation performed on files in a given FileView object shall not affect the file context associated with any 
other FileView object. This context can be transient or persistent depending on what was required by the 
Applet during the creation of the FileView object. 



5.1.3.1.1.2 



Parameter errors 



• CRRPl : If event is not one of the following values JCSystem.NOT_A_TRANSIENT_OBJECT, 

JCSystem.CLEAR_ON_DESELECT, or JCSystem.CLEAR_ON_RESET a SystemException is thrown. The 
value of the SystemException shall be SystemException.ILLEGAL_V ALUE. 



5.1.3.1.1.3 



Context errors 



CRRCl: If event is JCSystem.CLEAR_ON_RESET or JCSystem.CLEAR_ON_DESELECT and not enough 
transient memory space is available a SystemException shall be thrown with reason code 
SystemException.NO_TRANSIENT_SPACE. 

CRRC2: If event is JCSystem.CLEAR_ON_DESELECT and the applet is not a currently selected applet a 
SystemException with reason code SystemException. ILLEGAL_TRANSIENT shall be thrown. 
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5.1.3.1.2 

Test Source: 
Test Applet: 
Cap File: 

5.1.3.1.3 



5.1.3.1.4 



Test area files 

Test_ Api_l_Usy_Getfb.java. 
Api_l_Usy_Getfb_l .Java. 
api_l_usy_getfb.cap. 

Test coverage 



CRR number 


Test case number 


N1 


2 


N2 


1 


N3 


2 


N4 


2 


N5 


3 


P1 


7 


C1 


5,6 


C2 


4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


IVIetliod returns null 

Install Appletl with full access rights on 
the UICC file system 








Invoke the method getTheUICCView before 
the javacard. framework .Applet . register ( . . ) 


The method returns null 






method invocation 
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Id 


Description 


API Expectation 


APDU Expectation 


2 


Normal execution 








1- Envelope menu selection is sent to the 
UICC 


1 - Appletl is triggered 






Invoke the method getTheUICCView () with 
the event JCSystem.NOT_A_TRANSIENT_OBJECT 
and stores the result in a class variable 
FVl 

Appletl calls FVl. status () command 


No exception shall be thrown 
Current selected DF is the IVIF 






Select DFiest using FVl 
Select EFiaEo using FVl 
Read first 3 bytes using FVl 


Expected value is {FF FF FF} 






Reset 

Terminal profile 








2- Envelope menu selection is sent to the 
UICC 


2- Appletl is triggered 






Appletl calls FVl. status () command 


Current selected DF is DFjest 






Read first 3 bytes using FVl 
Appletl calls FVl . select {0x7FFF) 


Expected value is {FF FF FF} 
UICCException.FILE_NOT_FOUN 
D is thrown 






Invoke the method getTheUICCView () with 
the event JCSystem.CLEAR_ON_RESET and 
stores the result in a class variable FV2 


No exception shall be thrown 






Appletl calls FV2. status () command 

Select DFiest using FV2 
Select EFtaro using FV2 
Read first 3 bytes using FV2 


Current selected DF the IVIF 






Reset 

Terminal profile 


Expected value is {FF FF FF} 






4 - Envelope menu selection is sent to the 
UICC 








Appletl calls FV2. status () command 


4- Appletl is triggered 






Read first 3 bytes using FV2 


Current selected DF is the IVIF 






Appletl calls FV2 . select (0x7FFF) 


UlCCException. 
NO_EF_SELECTED 






5- Select the Applet by AID 

Invoke the method in the method process () 
getTheUICCView with the event 
JCSystem.CLEAR„ON_DESELECT and stores the 
result in a class variable FV3 


UlCCException. FILE_NOT_FOUN 
D is thrown 

5- Appletl is selected 

No exception shall be thrown 






Appletl calls FV3. status () command 








Select DFiest using FV3 
Select EFisRn using FV3 
Read first 3 bytes using FV3 


Current selected DF the MF 






Select ADF2 by AID 








6- Select the Applet by AID 
Appletl calls FV3. status () command 


Expected value is {FF FF FF} 






Read first 3 bytes using FV3 


6- Appletl is selected 
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Id 


Description 


API Expectation 


APDU Expectation 




Appletl calls FV3 . select (0x7FFF) 


Current selected DF is the MF 

UlCCException. 
NO EF SELECTED 
UlCCException. FILE_NOT_FOUN 
D is thrown 




3 


FileView context independency 

1- Envelope menu selection is sent to the 
UICC 

2- Check that previous fileviews are 
different (FVl != FV2 != FV3) 

3- Select DFiest/EFLaRo using FVl 

4- Select DFiest/EFcAHn using FV2 

5- Select DFiest/EFcaRo using FV3 

6- Read record number 1 using FVl (in 
absolute mode) 

7- Read record number 2 using FV2 (in 
absolute mode) 


1 - Appletl is triggered 

3- No exception shall be thrown 

4- No exception shall be thrown 

5- A security exception shall be 
thrown 

6- Expected value is "55 55 55 55" 

7- Expected value is "AA AA AA" 




4 


ILLEGAL_TRANSIENTSystemException 

1- Envelope menu selection is sent to the 
UICC 

2- Appletl calls getTheUICCView ( ) method 
with the event JCSystem.CLEAR_ON_DESELECT 


1 - Appletl is triggered 

2- SystemException. 
ILLEGAL_TRANSIENT is thrown 




5 


NO TRANSIENT SPACE SystemException 
with CLEAR_ON_RESET FileView object 

1- Get the available transient memory 
space using method 

length= JCSy stem. get Aval lableMemory (MEMORY_ 
TYPE_TRANSIENT_RESET) 

2- Fill the available transient memory 
space by creating array, using method 
JCSystem.makeTransientByteArray (length, 
JCSy stem. CLEAR_ON_RESET) 

3- Applet calls method getTheUICCView () 
with event 

JCSy stem. CLEAR_ON_RESET 

4- Reset 


1- No exception shall be thrown 

2- No exception shall be thrown 

3- SystemException. 
NO_TRANSIENT_SPACE is 
thrown 





ETSI 



Release 6 



91 



ETSI TS 102 268 V6.0.0 (2007-03) 



Id 


Description 


API Expectation 


APDU Expectation 


6 


NO TRANSIENT SPACE SystemException 
with CLEAR_ON_DESELECT FileView object 

1- Select the Applet by AID 

2- Get the available transient memory 
space using method 

length=JCSystem.getAvailableMemory (MEMORY_ 
TYPE_TRANSIENT_DESELECT) 

3- Fill the available transient memory 
space by creating array, using method 
JCSystem.makeTransientByteArray (length, 
JCSystem.CLEAR_ON_DESELECT) 

4- Applet calls method getTheUICCView () 
with event 
JCSystem.CLEAR„ON„DESELECT 


1- Appletl is selected 

2- No exception shall be thrown 

3- No exception shall be thrown 

4- SystemException. 
NO_TRANSIENT_SPACE is 
thrown 




7 


ILLEGAL_VALUE SystemException 

1- Invoke the method getTheUICCView () with 
event different from 0,1,2 


1- 

System Exception. ILLEGAL_VALU 

E is thrown 





5.1 .3.2 Method getTheFileView 

Test Area Reference: Api_l_Usy_Getfob. 

5.1.3.2.1 Conformance requirement: 

The method with following header shall compliant to its definition in the API. 

public static FileView getTheFileView ( javacard. framework. AID aid, byte event) 
throws NullPointerException, 

javacard. framework . SystemException 



5.1.3.2.1.1 



Normal execution 



• CRRNl: returns a reference to class which implements the FileView interface on an ADF file system defined 
by its AID. 

• CRRN2: returns null if the ADF with the AID does not exist 

• CRRN3: returns null if one of the javacard. framework. Applet.register(..) method has not previously invoked 
by the applet invoking this method or the filesystem server does not exist or the filesystem server returns null 

• CRRN4: After a successful invocation of the method the ADF is the currently selected file 

• CRRN5: A separate and independent file context shall be associated with each and every FileView object: the 
operation performed on files in a given FileView object shall not affect the file context associated with any 
other FileView object. This context can be transient or persistent depending on what was required by the 
Applet during the creation of the FileView object 

• CRRN6: It is not possible to access files which are not located under the ADF 

5.1 .3.2.1 .2 Parameters error 

• CRRPl : If event is not one of the following values JCSystem.NOT_A_TRANSIENT_OBJECT, 
JCSystem.CLEAR_ON_DESELECT, or JCSystem.CLEAR_ON_RESET a SystemException is thrown. The 
value of the SystemException shall be SystemException. ILLEGAL_VALUE. 

• CRRP2: If the AID is null a NullPointerException shall be thrown. 
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5.1.3.2.1.3 



Context errors 



• CRRCl : If event is JCSystem.CLEAR_ON_RESET or JCSystem.CLEAR_ON_DESELECT and not enough 
transient memory space is available a SystemException shall be thrown with reason code 
SystemException.NO_TRANSIENT_SPACE. 

• CRRC2: If event is JCSystem.CLEAR_ON_DESELECT and the applet is not a currently selected applet a 
SystemException with reason code SystemException. ILLEGAL_TRANSIENT shall be thrown. 



5.1.3.2.2 

Test Source: 
Test Applet: 
Cap File: 



Test area files 

Test_ Api_l_Usy_Getfob.java. 

Api_l_Usy_Getfob.java. 

api_l_usy_getfob.cap. 



5.1.3.2.3 



Test coverage 



5.1.3.2.4 



CRR number 


Test case number 


N1 


1-3 


N2 


1 


N3 


1 


N4 


2 


N5 


3 


N6 


2 


PI 


7 


P2 


8 


CI 


5,6 


C2 


4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


IVIethod returns null 

1- Install Appletl with full access rights 
on the UICC file system 








2- Invoke the method getTheFileView 
before the 


2- returns null 






javacard. framework .Applet . register ( . . ) 








method invocation 








3- Envelope menu selection is sent to the 








UICC 


3- applet is triggered 






4- Invoke the method getTheFileView () with 








AID = unknown ADF AID 


4- returns null 
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Id 



Description 



API Expectation 



APDU Expectation 



Normal execution 

1- Envelope menu selection is sent to the 
UICC 

Invoke the method getTheFileView () with 

AID = ADFl with the event 

JCSystem.NOT_A_TRANSIENT_OBJECT 

and stores the result in a class variable 

FVl 

Appletl calls FVl. status () command 



Select DFiest using FVl Select EFiaro using 
FVlRead first 3 bytes using 
FVlResetTerminal profile 

2 - Envelope menu selection is sent to the 
UICC 

Appletl calls FVl. status () command 

Read first 3 bytes using FVl 
Appletl calls FVl . select (0x3F00) 



Invoke the method getTheFileView () with 
the event JCSystem.CLEAR_ON_RESET and 
stores the result in a class variable FV2 

Appletl calls FV2. status () command 

Select DFiest using FV2 
Select EFiaro using FV2 
Read first 3 bytes using FV2 

Reset 

Terminal profile 

4 - Envelope menu selection is sent to the 
UICC 

Appletl calls FV2. status () command 

Read first 3 bytes using FV2 



Appletl calls FV2 .select (0x3F00) 



5- Select the Applet by AID 

Invoke the method getTheFileView () with 

AID = ADFlwith 

theevent : JCSystem.CLEAR_ON_DESELECT and 

stores the result in a class variable FV3 

Appletl calls FV3. status () command 

Select DFiest using FV3 Select EF-aro using 

FV3 

Read first 3 bytes using FV3 



6- Select the Applet by AID 
Appletl calls FV3. status () command 
Read first 3 bytes using FV3 

Appletl calls FV3 . select (0x3F00) 



1- Appletl is triggered 

No Exception shall be thrown 

Current selected DF is ADF1 



Expected value is {FF FF FF} 

2- Appletl is triggered 
Current selected DF is DFjest 
Expected value is {FF FF FF} 



UICCException.FILE_NOT_FOUN 

D is thrown 

No exception shall be thrown 



Current selected DF is the ADF1 



Expected value is {FF FF FF} 



4- Appletl is triggered 

Current selected DF is the ADFl 

UlCCException. 
NO EF SELECTED 



UlCCException. FILE_NOT_FOUN 
D is thrown 



5- Appletl is selected 

No Exception shall be thrown 
Current selected DF is ADF1 
Expected value is {FF FF FF} 

6- Appletl is selected 
Current selected DF is ADF1 
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Id 


Description 


API Expectation 


APDU Expectation 






UlCCException. 
NO_EF_SELECTED 

UlCCException. FILE_NOT_FOUN 
D is tlirown 




3 


FileView context independency 

1- Envelope menu selection is sent to the 
UICC 

2- Check that previous fileviews are 
different (FVl != FV2 != FV3) 

3- Select DFiest/EFLARo using FVl 

4- Select DFiest/EFcsRn using FV2 

5- Select DFiest/EFcAHn using FV3 

6- Read record number 1 using FVl (in 
absolute mode) 

7- Read record number 2 using FV2 (in 
absolute mode) 


1- Appletl is triggered 

3- No exception shall be thrown 

4- No exception shall be thrown 

5- A security exception shall be 
thrown 

6- Expected value is "55 55 55 55" 

7- Expected value is "AA AA AA" 




4 


ILLEGAL_TRANSIENTSystemException 

1- Envelope menu selection is sent to the 
UICC 

2- Appletl calls getTheFileView () method 
with the event JCSystem.CLEAR_ON_DESELECT 


1- Appletl is triggered 

2- SystemException. 
ILLEGAL_TRANSIENT is thrown 




5 


NO TRANSIENT SPACE SystemException 
with CLEAR_ON_RESET FileView object 

1 Get the available transient memory 

space using method 

length= JCSy stem. get Aval lableMemory (MEMORY_ 

TYPE_TRANSIENT_RESET) 

2- Fill the available transient memory 
space by creating array, using method 
JCSystem.makeTransientByteArray (length, 
JCSy stem. CLEAR_ON_RESET) 

3- Applet calls method getTheFileView ( ) 
with AID = ADFl 

with event 
JCSy stem. CLEAR_ON_RESET 

4- Reset 


1- No Exception shall be thrown 

2- No Exception shall be thrown 

3- SystemException. 
NO_TRANSIENT_SPACE is 
thrown 




6 


NO TRANSIENT SPACE SystemException 
with CLEAR_ON_DESELECT FileView object 

1 - Select the Applet by AID 

2- Get the available transient memory 
space using method 

length= JCSy stem. getAvailableMemory (MEMORY_ 
TYPE_TRANSIENT_DESELECT) 

3- Fill the available transient memory 
space by creating array, using method 
JCSystem.makeTransientByteArray (length, 
JCSystem.CLEAR_ON_DESELECT) 

} 

4- Applet calls method getTheFileView () 
with AID = ADFl 

with event : 
JCSy stem. CLEAR_ON_DESELECT 


1- Appletl is triggered 

2- No Exception shall be thrown 

3- No Exception shall be thrown 

4- SystemException. 
NO_TRANSIENT_SPACE is 
thrown 





ETSI 



Release 6 



95 



ETSI TS 102 268 V6.0.0 (2007-03) 



Id 


Description 


API Expectation 


APDU Expectation 


7 


ILLEGAL_VALUE System Exception 

1- Invoke the method getTheFileView () with 
event different from 0,1,2 


1- 

SystemException.lLLEGAL_VALU 
E is thrown 




8 


NullPointerException 

Invoke the method getTheFileView () with 
AID = NULL 

with event : 
1 - JCSystem.CLEAR_ON_RESET 


1- Shall be thrown 

java.lang. NullPointerException 





5.1 .3.3 Method getTheFileView 

Test Area Reference: Api_l_Usy_Getf_Bsbb. 

5.1.3.3.1 Conformance requirement: 

The method with following header shall compliant to its definition in the API. 

public static FileView getTheFileView (byte [ ] buffer, short bOffset, short bLength, byte event) 
throws NullPointerException, 

javacard. framework . SystemException, 
ArraylndexOutOf BoundException 



5.1.3.3.1.1 



Normal execution 



• CRRNl: returns a reference to class which implements the FileView interface on an ADF file system defined 
by its AID contains in buffer parameter. 

• CRRN2: returns null if the ADF with the full AID given in the buffer does not exist. 

• CRRN3: returns null if one of the javacard. framework.Applet.register(..) method has not previously invoked 
by the applet invoking this method or the filesystem server does not exist or the filesystem server returns null. 

• CRRN4: After a successful invocation of the method the ADF is the currently selected file. 

• CRRN5: A separate and independent file context shall be associated with each and every FileView object: the 
operation performed on files in a given FileView object shall not affect the file context associated with any 
other FileView object. This context can be transient or persistent depending on what was required by the 
Applet during the creation of the FileView object 

• CRRN6: It is not possible to access files which are not located under the ADF 

5.1.3.3.1.2 Parameters error 

• CRRPl : If event is not one of the following values JCSystem.NOT_A_TRANSIENT_OBJECT, 
JCSystem.CLEAR_ON_DESELECT, or JCSystem.CLEAR_ON_RESET a SystemException is thrown. The 
value of the SystemException shall be SystemException. ILLEGAL_VALUE. 

• CRRP2: If the buffer is null a NullPointerException shall be thrown. 

• CRRP3: If bOffset is less than 0, an instance ArraylndexOutOfBoundException shall be thrown 

• CRRP4: if bOffset plus bLength is greater than the length of the array buffer.length, an instance of 
ArraylndexOutOfBoundsException shall be thrown. 

• CRRP5: if bLength is not in the range of 5 - 16 bytes a SystemException.ILLEGAL_VALUE shall be thrown. 
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5.1.3.3.1.3 



Context errors 



• CRRCl : If event is JCSystem.CLEAR_ON_RESET or JCSystem.CLEAR_ON_DESELECT and not enough 
transient memory space is available a SystemException shall be thrown with reason code 
SystemException.NO_TRANSIENT_SPACE. 

• CRRC2: If event is JCSystem.CLEAR_ON_DESELECT and the applet is not a currently selected applet a 
SystemException with reason code SystemException. ILLEGAL_TRANSIENT shall be thrown. 

5.1.3.3.2 Test area files 

Test Source: Test_ Api_l_Usy_Getf_Bsbb.java. 
Test Applet: Api_l_Usy_Getf_Bsbb.java. 

Cap File: api_l_usy_getf_bsbb.cap. 



5.1.3.3.3 



Test coverage 



CRR number 


Test case number 


N1 


2 


N2 


1 


N3 


2 


N4 


2 


N5 


3 


N6 


2 


PI 


7 


P2 


8 


P3 


9 


P4 


9 


P5 


10 


CI 


5,6 


C2 


4 



5.1.3.3.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


IVIethod returns null 

1- Install Appletl with full access rights 
on the UICC file system 

2- Invoke the method getlheFileView 
before the 

javacard. framework .Applet . register ( . . ) 

method invocation 

Invoke the method getlheFileView () with 

buffer[20] = {ADFl,...} 

bOffset= 

bLength= 16 

3- Envelope menu selection is sent to the 
Dice 

4- Invoke the method getlheFileView 
before the 

javacard. framework .Applet . register (..) 

method invocation 

Invoke the method getlheFileView () with 

buffer [20] = null 

bOffset= 

bLength= 16 


2- returns null 

3- Applet Is triggered 

4- returns null 
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Id 



Description 



API Expectation 



APDU Expectation 



Normal execution 

1- Envelope menu selection is sent to the 
UICC 

Invoke the method getTheFileView () 

with buffer[20] = {ADFl,...} 

bOffset= 

bLength= 16 

JCSystem.NOT_A_TRANSIENT_OBJECT 

and stores the result in a class variable 

FVl 

Appletl calls FVl. status () command 



Select DFiest using FVl 
Select EFtaro using FVl 
Read first 3 bytes using FVl 

Reset 

Terminal profile 

2 - Envelope menu selection is sent to the 
UICC 

Appletl calls FVl. status () command 

Read first 3 bytes using FVl 

Appletl calls FVl . select (0x3F00) 

Invoke the method getTheFileView () with 
the event JCSystem.CLEAR_ON_RESET and 
stores the result in a class variable FV2 

Appletl calls FV2. status () command 

Select DFiest using FV2 
Select EFiaEo using FV2 
Read first 3 bytes using FV2 

Reset 

Terminal profile 

4 - Envelope menu selection is sent to the 
UICC 

Appletl calls FV2. status command 

Read first 3 bytes using FV2 



Appletl calls FV2 . select (0x3F00) 

5- Select the Applet by AID 

Invoke the method getTheFileView () with 

AID = ADFl with 

buffer[20] = {ADFl,...} 

bOffset= 

bLength= 16 

the event :JCSy stem. CLEAR_ON_DESELECT and 

stores the result in a class variable FV3 

Appletl calls FV3. status () command 

Select DFiest using FV3 

Select EFiAEo using FV3 

Read first 3 bytes using FV3 

6- Select the Applet by AID 
Appletl calls FV3. status () command 
Read first 3 bytes using FV3 



1- Appletl is triggered 

No Exception shall be thrown 



Current selected DF is ADF1 

Expected value is {FF FF FF} 

2- Appletl is triggered 

Current selected DF is DFjest 

Expected value is {FF FF FF} 

UICCException.FILE_NOT_FOUN 
D is thrown 

No exception shall be thrown 
Current selected DF is ADF1 

Expected value is {FF FF FF} 

4- Appletl is triggered 

Current selected DF is ADF1 

UlCCException. 
NO EF SELECTED 



UlCCException. FILE_NOT_FOUN 

D is thrown 

5- Appletl is selected 

No Exception shall be thrown 



Current selected DF is ADF1 



Expected value is {FF FF FF} 

6- Appletl is selected 
Current selected DF is ADF1 
UlCCException. 
NO EF SELECTED 
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Id 


Description 


API Expectation 


APDU Expectation 




Appletl calls FV3 . select (0x3F00) 


UICCException.FILE_NOT_FOUN 
D is thrown 




3 


FileView context independency 

1- Envelope menu selection is sent to the 
UICC 

2- Check that previous fileviews are 
different (FVl != FV2 != FV3) 

3- Select DFiest/EFLaRn using FVl 

4- Select DFiest/EFcsRn using FV2 

5- Select DFiest/EFcsRn using FV3 

6- Read record number 1 using FVl (in 
absolute mode) 

7- Read record number 2 using FV2 (in 
absolute mode) 


1- Appletl is triggered 

3- No exception shall be thrown 

4- No exception shall be thrown 

5- A security exception shall be 
thrown 

6- Expected value is "55 55 55 55" 

7- Expected value is "AA AA AA" 




4 


ILLEGAL_TRANSIENTSystemException 

1- Envelope menu selection is sent to the 
UICC 

2- Appletl calls getTheFileView () method 
with 

buffer[20] = {ADFl,...} 

bOffset= 

bLength= 16 

with 

the event JCSystem.CLEAR_ON_DESELECT 


1- Appletl is triggered 

2- SystemException. 
ILLEGAL_TRANSIENT is thrown 




5 


NO TRANSIENT SPACE SystemException 
with CLEAR_ON_RESET FileView object 

1 Get the available transient memory 

space using method 

length= JCSy stem. get Aval lableMemory (MEMORY_ 

TYPE_TRANSIENT_RESET) 

2- Fill the available transient memory 
space by creating array, using method 
JCSystem.makeTransientByteArray (length, 
JCSy stem. CLEAR_ON_RESET) 

3- Applet calls method getTheFileView () 
with buffer [20] = {ADFl,...} 

bOffset= 

bLength= 16 

with the event 

JCSy stem. CLEAR_ON_RESET 

4- Reset 


1- No Exception shall be thrown 

2- No Exception shall be thrown 

3- SystemException. 
NO_TRANSIENT_SPACE is 
thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


6 


NO TRANSIENT SPACE SystemException 
with CLEAR_ON_DESELECT FileView object 

1 - Select the Applet by AID 

2- Get the available transient memory 
space using method 

length=JCSystem.getAvailableMemory (MEMORY_ 
TYPE_TRANSIENT_DESELECT) 

3- Fill the available transient memory 
space by creating array, using method 
JCSystem.makeTransientByteArray (length, 
JCSystem.CLEAR_ON_DESELECT) 

} 

4- Applet calls method getTheFileView ( ) 
with buffer [20] = {ADFl,...} 

bOffset= 

bLength= 16 

with event : 

JCSy stem . CLEAR_ON_DESELECT 


1- Appletl is triggered 

2- No Exception shall be thrown 

3- No Exception shall be thrown 

4- SystemException. 
NO_TRANSIENT_SPACE is 
thrown 




7 


ILLEGAL_VALUE SystemException 

1- Invoke the method getTheFileView () with 
event different from 0,1,2 


1- 

SystemException.lLLEGAL_VALU 
E is thrown 




8 


NullPointerException 

Invoke the method getTheFileView () with 
buffer [20] = null 
bOffset= 
bLength= 16 

with event : 
1 - JCSy stem. CLEAR_ON_RESET 


1- Shall be thrown 

java.lang. NullPointerException 




9 


ArraylndexOutOfBoundsException 

l-Envelope menu selection is sent to the 
UICC 

Invoke the method getTheFileView () with 

buffer[20] = {ADFl,...} 

bOffset= 5 

bLength= 16 

event = JCSy stem. CLEAR_ON_RESET 

Invoke the method getTheFileView () with 

buffer[20] = {ADFl,...} 

bOffset= -1 

bLength= 16 

event = JCSy stem. CLEAR_ON„RESET 


1- Appletl is triggered 

Shall be thrown 
ArraylndexOutOfBoundsException 

Shall be thrown 
ArraylndexOutOfBoundsException 




10 


SystemException.lLLEGAL_VALUE 

l-Envelope menu selection is sent to the 

UICC 

Invoke the method getTheFileView () with 

buffer[20] = {ADFl,...} 

bOffset= 

bLength= 4 

event = JCSy stem. CLEAR_ON_RESET 

Invoke the method getTheFileView () with 

buffer[20] = {ADFl,...} 

bOffset= 

bLength= 17 

event = JCSy stem. CLEAR_ON_RESET 


1- Appletl is triggered 

System Exception. ILLEGAL_VALU 
E shall be thrown 

SystemException. ILLEGAL_VALU 
E shall be thrown 
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5.1.4 Interface UlCCException 
5.1.4.1 Constructor 

Test Area Reference: Api_l_Uex_Coor. 

5.1 .4.1 .1 Conformance Requirement: 

The method with following header shall compliant to its definition in the API. 

public UlCCException (short reason) 

throws UlCCException 

5.1.4.1.1.1 Normal execution 

• CRRNl: Construct an UlCCException with the specified reason. 

5.1.4.1.1.2 Parameter errors 
No requirements. 

5.1.4.1.1.3 Context errors 
No requirements. 

5.1.4.1.2 

Test Source: 
Test Applet: 
Cap File: 

5.1.4.1.3 



Test suite files 

Test_Api_2_Uex_Coor.j ava. 
Api_2_Uex_Coor_ 1 .j ava. 
api_2_uex_coor.cap. 

Test Coverage 



CRR number 


Test case number 


N1 


1 



5.1.4.1.4 



Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


UlCCException with the specified reason 

(The reason shall set with setReason and 
compare the Exception with getReason) 


Reason (specified) 





5.1.4.2 Method throwit 

Test Area Reference: Api_l_Uex_Thit. 

5.1.4.2.1 Conformance Requirement: 

The method with following header shall be compliant to its definition in the API. 

public static void throwit (short reason) 
throws UlCCException 
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5.1 .4.2.1 .1 Normal execution 

• CRRNl: Throws the JCRE owned instance of UICCException with the specified reason. 

• CRRN2: extends javacard.framework.CardRuntimeException. 

5.1.4.2.1.2 Parameter errors 
No requirements. 

5.1.4.2.1.3 

No requirements. 



5.1.4.2.2 

Test Source: 
Test Applet: 
Cap File: 

5.1.4.2.3 



Context errors 
Test area files 

Test_Api_2_Uex_Thit.j ava. 
Api_2_Uex_Thit_ 1 .j ava. 
api_2_uex_thit. cap . 

Test Coverage 



CRR number 


Test case number 


N1 


1,2,3 


N2 


4,5,6 



5.1.4.2.4 



Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Tlirows tlie JCRE instance of UICCException 
with the specified reason 


Reason = 




2 


Throws the JCRE instance of UICCException 
with the specified reason 


Reason = 1 




3 


Throws the JCRE instance of UICCException 
with the specified reason 


Reason = 0xA55A 




4 


UICCException extends 
javacard.framework.CardRuntimeException 


Reason = 




5 


UICCException extends 
javacard.framework.CardRuntimeException 


Reason = 1 




6 


UICCException extends 
javacard.framework.CardRuntimeExceptlon 


Reason = 0xA55A 





5.1.4.3 Reason Codes 

This part contain only constant defined for the available reason code. No test of constants will be performed. 

5.1.5 Contexts 
5.1.5.1 Context tests 

Test Area Reference: Api_l_Cont 
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5.1.5.1.1 



Conformance requirement 



5.1.5.1.1.1 



Normal execution 



CRRNl: A file (EF, DF or ADF) can be accessed (selected, read, updated, deleted, deactivated, activated, 
increased, searched, resized) concurrently by different UlCC-based applications such as toolkit applications. 

CRRN2: A file (EF, DF or ADF) created by a File View can be accessed by other applications and vice versa. 

CRRN3: If a file is indicated as shareable (in the file descriptor byte in the FCP), then applications may 
perform authorized operations (selected, read, updated, deleted, deactivated, activated, increased, searched, 
resized, deleted) on the file independently of whether or not the file is the current file of any other application. 
A consequence is that if changes to a shareable file are permitted by the file's security conditions, then the file 
can be changed by one application while it is currently selected and being used by a second application. 

CRRN4: If a file is indicated as non-shareable and is the current file of one application, then another 
application cannot perform any operation on the file regardless of authorization. A consequence is that an 
application acquires exclusive access to a not-shareable file by successfully selecting it. Access by any other 
application, including an attempt to select the file, shall return an error indication. 

CRRN5: Concurrent access to a file by two executing instances of a single application is considered to be 
accessed by two different applications. 



5.1.5.1.1.2 

No requirements. 



Parameter errors 



5.1.5.1.1.3 

No requirements. 



Context errors 



5.1.5.1.2 

Test Source: 
Test Applet: 
Cap File: 



Test area files 

Api_ 1 _Cont.j ava. 
Api_l_Cont _l.java. 
api_l_cont.cap. 



5.1.5.1.3 



Test coverage 



CRR number 


Test case number 


N1 


1,2,3,4,5,6,7,8,9, 10 


N2 


1,2,3,4,5,6,7,8,9, 10 


N3 


1,2,3,4,5,6,7,8,9, 10 


N4 


11, 12, 13, 14, 15, 16 


N5 


1,2,3,4,5,6,7,8,9, 10 
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5.1.5.1.4 



Test procedure 



Id 



Description 



API Expectation 



APDU Expectation 



1- Select DF telecom 

2- Trigger applet 

3- Applet gets object UICCFileViewl using 
getTheUICCViewO 

4- Applet gets object UICCFileView2 using 
getTheUICCViewO 

5- Applet gets object ADFlFileViewl using 
getTheFileView ( ) 

6- Applet gets object ADFlFileView2 using 
getTheFileView ( ) 

7- Applet gets object UICCAdminFileViewl 
using getTheUICCAdminFileView () 

8- Applet gets object UICCAdminFileView2 
using getTheUICCAdminFileView () 

9- Applet gets object ADFlAdminFileViewl 
using getTheAdminFileView () 

10- Applet gets object ADFlAdminFileView2 
using getTheAdminFileView () 



Select and status 



1- UICCFileViewl. select DFiest, 
UICCFileViewl. select EFiaEo, 

2- UICCFileViewl. select ADFl 



3- UICCFileView2. select EFoicc, 

4- UICCFileView2 .select ADFl 



5- ADFlFileViewl . select DFielecom, 

6- ADFlFileViewl. select MF 



7- ADFlFileView2 .select DFiest, 
ADFlFileView2 . select ( ) DFsobjest 

8- ADFlFileView2 .select MF 



UICCFileViewl. status () 



10- UICCFileView2 . status () 



11- ADFlFileViewl. status () 



12- ADFlFileView2 . status () 



13- Status 



2- 

UICCException.FILE_NOT_FOUN 
D is thrown 



UICCException.FILE_NOT_FOUN 
D is tlirown 



UICCException.FILE_NOT_FOUN 
D is tlirown 



UICCException.FILE_NOT_FOUN 
D is tlirown 



9- FCP corresponding to DFtest 
(under IVIF) is returned 

10- FCP corresponding to MF is 
returned 

1 1 - FCP corresponding to 
DFtelecom (under ADF1 ) is 
returned 

12- FCP corresponding to 
DFsuB_TEST (under ADFl) is 
returned 

Applet finalizes 



13- FCP corresponding to 
DF TELECOM (under IVIF) is 
returned 
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Id 



Description 



API Expectation 



APDU Expectation 



Select SFI 

1- UICCFileViewl. select DFiest, 
UICCFileViewl. select EF™e with SFI 01, 
UICCFileViewl .deactivate () 

2- UICCFileViewl .select SFI 06 



3- UICCFileView2. select DFiest, 
UICCFileView2 .select EFtaro with SFI 03, 
UICCFileView2 .updateBinary 01 01 

4- UICCFileView2 .select SFI 08 



5- ADFlFileViewl . select DFtest, 
ADFlFileViewl . select () EFcnr with SFI 04 
ADFlFileViewl .deactivate () 

6- ADFlFileViewl .select SFI 06 



7- ADFlFileView2 .select DFtest, 
ADFlFileView2 .select EFtaro with SFI 03, 
ADFlFileView2 .updateBinary 02 02 

8- ADFlFileView2 .select SFI 08 



9- select DF test, select EFtnr 

10- activate 

11- select DF test, select EFtaro 

12- readBinary 

13- updateBinary FF FF FF... 

14- select AID of ADFl, select DF test, 
select EFcNR 

15- activate 

16- select EFtaro, 

17- readBinary 

18- updateBinary FF FF FF... 



1- No exception is thrown 



UICCException.FILE_NOT_FOUN 
D is tlirown 

3- No exception is thrown 



UICCException.FILE_NOT_FOUN 
D is thrown 

5- No exception is thrown 



UICCException.FILE_NOT_FOUN 
D is thrown 

7- No exception is thrown 

8- 

UICCException.FILE_NOT_FOUN 
D is thrown 

Applet finalizes 



1 0- SW=90 00 
12- Returns 01 01 

1 5- SW=90 00 
1 7- Returns 02 02 



ReadBinary and updateBinary 

1- Reset 

2- Trigger the applet 



3- UICCFileViewl. select DFtest, 
UICCFileViewl .select EFtaro, 
UICCFileViewl .updateBinary 01 01 01 01, 
offset 

4- UICCFileViewl .readBinary , offset 



5- UICCFileView2. select DFtest, 
UICCFileView2. select EFtaro, 
UICCFileView2 .updateBinary 02 02, offset 
2 

6- UICCFileView2 .readBinary , offset 



7- ADFlFileViewl .select DFtest, 
ADFlFileViewl . select EFtaro, 
ADFlFileViewl .updateBinary 03 03 03 03, 
offset 

8- ADFlFileViewl .readBinary , offset 



3- No exception Is thrown 



4- Returns 01 01 01 01 



5- No exception is thrown 



6- Returns 01 01 02 02 



7- No exception is thrown 
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Id 



Description 



API Expectation 



APDU Expectation 



9- ADFlFileView2 .select DFiest, 
ADFlFileView2 .select EFtaro, 
ADFlFileView2 .updateBinary 04 04, offset 
2 

10- ADFlFileView2 .readBinary , offset 



11- select DF test, select EF taro, 
readBinary 

12- updateBinary FF FF FF... 

13- select AID of ADFl, select DF test, 
select EF taro, readBinary 

14- updateBinary FF FF FF... 



8- Returns 03 03 03 03 

9- No exception is thrown 

10- Returns 03 03 04 04 
Applet finalizes 



11- Returns 01 01 02 02 



13- Returns 03 03 04 04 



Search Record 

1- Reset 

2- Trigger the applet 

3- UICCFileViewl. select DFtest, 
UICCFileViewl. select EFlopc, 
UICCFileViewl .searchRecordO 22 22 22 22 
22 22 22 22 22 22 

4- UICCFileViewl .updateRecordO current 33 
33 33 33 33 33 33 33 33 33 

5- UICCFileView2. select DFtest, 
UICCFileView2. select EFlopc, 
UICCFileView2 . readRecordO current 

6- UICCFileView2 .searchRecordO 22 22 22 
22 22 22 22 22 22 22, 



7- UICCFileView2 .searchRecordO 33 33 33 
33 33 33 33 33 33 33 



8- ADFlFileViewl .select DFtest, 
ADFlFileViewl. select EFlopc, 
ADFlFileViewl .searchRecordO 33 33 33 33 
33 33 33 33 33 33 

9- ADFlFileViewl .searchRecordO 22 22 22 
22 22 22 22 22 22 22 

10- ADFlFileViewl . updateRecord ( ) current 

11 11 11 11 11 11 11 11 11 11 



11- ADFlFileView2 .select DFtest, 
ADFlFileView2 . select EFlopc, 
ADFlFileView2 .searchRecordO 22 22 22 22 
22 22 22 22 22 22 

12- ADFlFileView2 .searchRecordO 11 11 11 

11 11 11 11 11 11 11 



13- select DF test, select EFlopc, readRecord 
01 

14- readRecord 02 

15- updateRecord 01, 11 11 11 11 11 11 11 
11 11 11 

16- updateRecord 02, 22 22 22 22 22 22 22 
22 22 22 

17- select AID of ADFl, select DF test, 
select EFlopc, readRecord 01 



3- returns 2 



4- No exception is thrown 



UICCException.RECORD_NOT_F 
OUND is thrown 

6- returns 

7- returns 2 

8- returns 



9- returns 2 



10- No exception is thrown 



11- returns 



12- returns 1 and 2 
Applet finalizes 



13- returns 11 11111111 
11 11 11 11 11 

14- returns 33 33 33 33 33 
33 33 33 33 33 



17- returns 11 11111111 
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Id 


Description 


API Expectation 


APDU Expectation 




18- readRecord 02 




11 11 11 11 11 




19- updateRecord 01 11 11 11 11 11 11 11 

11 11 11 




1 8- returns 11 11 11 11 11 
11 11 11 11 11 




20- updateRecord 02 22 22 22 22 22 22 22 








22 22 22 






5 


readRecord and updateRecord 

1- Reset 

2- Trigger the applet 








3- UICCFileViewl. select DFiest, 


3- No exception is thrown 






UICCFileViewl. select EFlaro, 








UICCFileViewl. updateRecord 66 66 66 66, 








next 








4- UICCFileViewl .readRecord , current 

5- UICCFileViewl .readRecord , next 


4- returns 66 66 66 66 

5- returns AA AA AA AA 






6- UICCFileView2. select DFiest, 
UICCFileView2. select EFlaro, 


6- 
UICCException.RECORD_NOT_F 






UICCFileView2 . readRecord ( ) , current 


OUND is thrown 






7- UICCFileView2. updateRecord BB BB BB 
BB, record 2 


7- No exception is thrown 






8- UICCFileView2 .readRecord , next 

9- UICCFileView2 .readRecord , next 


8- returns 66 66 66 66 

9- returns BB BB BB BB 






10- ADFlFileViewl. select DFiest, 
ADFlFileViewl. select EFlsro, 


10- No exception is thrown 






ADFlFileViewl. updateRecord 44 44 44 44, 








next 








11- ADFlFileViewl .readRecord , current 

12- ADFlFileViewl . readRecord , next 


1 1 - returns 44 44 44 44 
1 2- returns AA AA AA AA 






13- ADFlFileView2. select DFiest, 


13- 






ADFlFileView2. select EFlaro, 
ADFlFileView2 . readRecord ( ) , current 


UICCException.RECORD_NOT_F 
OUND is thrown 






14- ADFlFileView2. updateRecord 99 99 99 
99, record 2 


14- No exception is thrown 






15- ADFlFileView2 . readRecord , next 


1 5- returns 44 44 44 44 






16- ADFlFileView2 . readRecord , next 


16- returns 99 99 99 99 
Applet finalizes 






17- select DF test, select EF iaro, 
readRecord next 




17- returns 66 66 66 66 




18- readRecord next 




18- returns BB BB BB BB 




19- updateRecord record 1, 55 55 55 55 








2 0- updateRecord record 2, AA AA AA AA 








21- select AID of ADFl, select DF test, 
select EFlaro, readRecord next 




21- returns 44 44 44 44 




22- readRecord next 




22- returns 99 99 99 99 




23- updateRecord record 1, 55 55 55 55 








24- updateRecord record 2, AA AA AA AA 
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Id 

6 



Description 



API Expectation 



APDU Expectation 



ActivateFile and deactivateFile 

1- Reset 

2- Trigger the applet 

3- UICCFileViewl. select DFiest, 
UICCFileViewl .select EFrau, 
UICCFileViewl .deactivate 

4- UICCFileView2. select DFiest, 
UICCFileView2. select EF™o, 
UICCFileView2 . readBinary ( ) 

5- UICCFileView2 .activate , 
UICCFileView2 . readBinary ( ) 

6- UICCFileView2 . deactivate { ) 

7- ADFlFileViewl .select DFiest, 
ADFlFileViewl . select EFino, 
ADFlFileViewl .readBinary () 

8- ADFlFileViewl. deactivate () 

9- ADFlFileView2 .select DFiest, 
ADFlFileView2 . select EFinu, 
ADFlFileView2 . readBinary ( ) 

10- ADFlFileView2 .activate , 
ADFlFileView2 .readBinary () 

11- select DF tesi, select EFinu 

12- activate 

13- select AID of ADFl, select DF test, 
select EFiNu 



3- No exception is thrown 



UICCException.REF_DATA_INVAL 
IDATED is tlirown 

5- returns 55 55 55 

6- No exception is thrown 

7- returns 55 55 55 



8- No exception is thrown 

9- 

UICCException.REF_DATA_INVAL 
IDATED is thrown 



10- returns 55 55 55 
Applet finalizes 



11 - SW = 62 83 
12-SW = 90 00 
13-SW = 90 00 



Increase 



1- Reset 



2- Trigger the applet 

3- UICCFileViewl. select DFiest, 
UICCFileViewl. select EFcsro, 
UICCFileViewl. updateRecordO 00 00 00, 
previous 

UICCFileViewl. updateRecordO 00 00 00, 
previous 

4- UICCFileViewl .increase , 00 00 01 

5- UICCFileViewl . readRecord , current 

6- UICCFileViewl . readRecord , previous 

7- UICCFileView2. select DFiest, 
UICCFileView2. select EFcsro, 
UICCFileView2 . readRecord ( ) , current 

8- UICCFileView2 .increase , 00 00 01 

9- UICCFileView2 .readRecord , current 

10- UICCFileView2 . readRecord , previous 

11- ADFlFileViewl .select DFiest, 
ADFlFileViewl .select EFcaro, 
ADFlFileViewl . readRecord ( ) , current 

12- ADFlFileViewl .updateRecordO 00 00 00, 
previous 

ADFlFileViewl .updateRecordO 00 00 00, 
previous 

13- ADFlFileViewl. increase , 00 00 02 

14- ADFlFileViewl . readRecord , current 

15- ADFlFileViewl . readRecord , previous 



3- No exception is thrown 



4- respG = 00 00 01 

5- returns 00 00 01 

6- returns 00 00 00 
7- 

UICCException.RECORD_NOT_F 
OUND is thrown 

8- respG = 00 00 02 

9- returns 00 00 02 
10- returns 00 00 01 

11- 

UICCException.RECORD_NOT_F 
OUND is thrown 

12- No exception is thrown 



13-resp[] = 00 00 02 
14- returns 00 00 02 
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Id 


Description 


API Expectation 


APDU Expectation 






15- returns 00 00 00 






16- ADFlFileView2. select DFjest, 


16- 






ADFlFileView2. select EFcsro, 
ADFlFileView2 . readRecord ( ) , current 


UICCException.RECORD_NOT_F 
OUND is thrown 






17- ADFlFileView2. increase , 00 00 02 


17-resp[] = 00 00 04 






18- ADFlFileView2 .readRecord , current 








19- ADFlFileView2 .readRecord , previous 


18- returns 00 00 04 






20- select DF test, select EFcaro, readRecord 
current 


19- returns 00 00 02 
Applet finalizes 


20- SW = 6A 83 




21- readRecord previous 

22- readRecord previous 




21- returns 00 00 01 

22- returns 00 00 02 




2 3- updateRecord previous AA AA AA 








24- updateRecord previous 55 55 55 




23- SW = 90 00 




25- select AID of ADFl, select DF test, 
select EFcARu, readRecord current 




24- SW = 90 00 

25- SW = 6A 83 




2 6- readRecord previous 








27- readRecord previous 




26- returns 00 00 02 

27- returns 00 00 04 




2 8- updateRecord previous AA AA AA 








29- updateRecord previous 55 55 55 




28- SW = 90 00 

29- SW = 90 00 


8 


CreateFile EF 

1- Reset 

2- Trigger the applet 








3- UICCAdminFileViewl. select DFtest, 
UICCAdminFileViewl. select 6F 2 9 


3- 

UICCException.FILE_NOT_FOUN 
D is thrown 






4- UICCAdminFileViewl. create 6F 2 9 


4- No exception is thrown 






5- UICCAdminFileViewl. select 6F 2 9 


5- No exception is thrown 






6- UICCAdminFileView2. select DFtest, 
UICCAdminFileView2. select {) 6F 2 9 


6- No exception is thrown 

7- 

UICCException.FILE_NOT_FOUN 






7- UICCAdminFileView2. select 6F 2A 








D is thrown 






8- UICCAdminFileView2. create 6F 2A 


8- No exception is thrown 






9- UICCAdminFileViewl. select 6F 2A 

10- UICCAdminFileViewl. select 6F 29 


9- No exception Is thrown 

10- No exception is thrown 
11- 
UICCException.FILE_NOT_FOUN 












11- ADFlAdminFileViewl. select DFtest, 


D is thrown 






ADFlAdminFileViewl. select 6F 2 9 








12- ADFlAdminFileViewl .create {) 6F 2 9 

13- ADFlAdminFileViewl. select 6F 2 9 


12- No exception is thrown 

13- No exception is thrown 






14- ADFlAdminFileView2 . select DFtest, 
ADFlAdminFileView2. select 6F 2 9 


14- No exception is thrown 






15- ADFlAdminFileView2. select 6F 2A 


15- 

UICCException.FILE_NOT_FOUN 
D is thrown 






16- ADFlAdminFileView2 .create 6F 2A 


16- No exception is thrown 






17- ADFlAdminFileViewl. select 6F 2A 

18- ADFlAdminFileViewl. select {) 6F 29 


17- No exception is thrown 

18- No exception is thrown 






21- select DF test, select 6F 29 


Applet finalizes 


21 - SW = 90 00 




22- select 6F 2A 




22- SW = 90 00 




23- select AID of ADFl, select DF test, 
select 6F 29 




23- SW = 90 00 
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Id 


Description 


API Expectation 


APDU Expectation 




24- 


- select 6F 2A 






24- SW = 90 00 


9 


1- 
2- 


CreateFile DF 

Reset 

Trigger the applet 










3- UICCAdminFileViewl . select 
UICCAdminFileViewl. select 5F 


DFtest, 
01 


3- 

UICCException.FILE_NOT_FOUN 
D is thrown 






4- 


UICCAdminFileViewl . create ( ) 


5F 01 








5- 


UICCAdminFileViewl . select ( ) 


5F 01 


4- No exception is thrown 






6- 


UICCAdminFileView2 . select ( ) 


DFtest, 


5- No exception is thrown 






UICCAclminFileView2. select 5F 


01 








7- 


UICCAdminFileView2 . select ( ) 


5F 02 


6- No exception is thrown 

7- 

UICCExGeption.FILE_NOT_FOUN 






8- 


UICCAdminFileView2 . create { ) 


5F 02 












D is thrown 






9- 
10- 


UICCAdminFileViewl . select ( ) 
- UICCAdminFileViewl . select 


5F 02 
5F 01 


8- No exception is thrown 

9- No exception is thrown 






11- 
ADI 






10- No exception is thrown 






"lAdminFileViewl . select 5F 


01 


11- 

UICCException.FILE_NOT_FOUN 
D is thrown 






12- 
13- 


- ADFlAdminFileViewl .create 

- ADFlAdminFileViewl . select 


5F 01 
5F 01 






14- 
15- 


- ADFlAdminFileView2 . select 
~ ADFlAdminFileView2 . select 


5F 01 
5F 02 


12- No exception is thrown 

13- No exception is thrown 






16- 


- ADFlAdminFileView2 . create 


5F 02 








17- 


~ ADFlAdminFileViewl . select 


5F 02 


14- No exception is thrown 

15- 

UICCException.FILE_NOT_FOUN 






18- 


- ADFlAdminFileViewl . select 


5F 01 












D is thrown 






21- 


- select 5F 01 




16- No exception is thrown 






22- 


- select 5F 02 




17- No exception is thrown 






23- 

24- 


- select AID of ADFl, select 

- select 5F 02 


5F 01 


18- No exception is thrown 
Applet finalizes 


21 - SW = 90 00 

22- SW = 90 00 

23- SW = 90 00 

24- SW = 90 00 
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Id 


Description 


API Expectation 


APDU Expectation 


10 


ReslzeFlle 

1- Reset 

2- Trigger the applet 








3- UICCAdminFileViewl. select DFiest, 
UICCAdminFileViewl. select () EFidac, 
UICCAdminFileViewl .readBinary , length 06 

4- UICCAdminFileViewl .resize , add 3 bytes 
UICCAdminFileViewl . readBinary , length 06 


3- 

UlCCException.OUT OF FILE BO 

UNDARIES is thrown 






5- UICCAdminFileView2. select DFiest, 
UICCAdminFileView2. select () EFidac, 
UICCAdminFileView2 .readBinary , length 06 


4- returns 00 00 00 FF FF FF 






6- UICCAdminFileViewl . resize , remove 2 
bytes 


5- returns 00 00 00 FF FF FF 

6- No exception is thrown 






7- ADFlAdminFileViewl. select DFiest, 
ADFlAdminFileViewl . select ( ) EFlnu, 
ADFlAdminFileViewl . readRecord ( ) , record 4 

8- ADFlAdminFileViewl . resize , add 2 
records 

ADFlAdminFileViewl . readRecord {), record 4 


7- 

UICCException.RECORD_NOT_F 
OUND is thrown 






9- ADFlAdminFileVie2. select DFiest, 
ADFlAdminFileView2. select () EFlnu, 
ADFlAdminFileView2 .readRecord (), record 4 


8- returns FF FF FF FF 






10- ADFlAdminFileView2 . resize , remove 1 
record 


9- returns FF FF FF FF 






11- select DF iest^ select EFidac^ readBinary 
length 06 

12- readBinary length 04 

13- resize, remove 1 byte 


10- No exception is thrown 
Applet finalizes 


11- R-APDU = 00 00 00 FF 
90 00 or 
62 82 or 
67 00 




14- select AID of ADFl, select DF test, 
select EFlnu/ readRecord record 4 




12- returns 00 00 00 FF 




15- readRecord record 3 




1 3- SW = 90 00 




16- resize, remove 1 record 




14-SW = 6A83 

15- returns FFFFFFFF 

1 6- SW = 90 00 


11 


Non-Shareable files (UlCCFileView - 
UlCCFileView) 

1- Reset 

2- Trigger the applet 








3- UICCFileViewl. select DFiest, 
UICCFileViewl. select EFhosh 


3- No exception is thrown 






4- UICCFileView2. select DFiest, 
UICCFileView2 . select ( ) EFhosh 

5- UICCFileViewl. select DFiest 


4- 

UICCException.lNTERNAL_ERRO 
R is thrown or 

UlCCException.FILE NOT FOUN 
D 






6- UICCFileView2. select OEFhosh 


5- No exception is thrown 

6- No exception is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 










12 


Non-shareable files (FileView - FileView) 

1- Reset 

2- Trigger the applet 

3- ADFlFileViewl. select DFiest, 
ADFlFileViewl . select ( ) EFhosh 

4- ADFlFileView2. select DFtest, 
ADFlFileView2 . select { ) EFhosh 

5- ADFlFileViewl. select DFiest 

6- ADFlFileView2. select OEFhosh 


3- No exception is thrown 

4- 

UICCException.lNTERNAL_ERRO 
R is tlirown or 

UlCCException.FILE NOT FOUN 
D 

5- No exception is thrown 

6- No exception is thrown 




13 


Non-Shareable files (UlCCFileView - MP) 

1- Trigger the applet 

2- UICCFileViewl. select DFiest, 
UICCFileViewl. select OEFhosh 

4- Select DFiest, select EFhosh 

5- Fetch and terminal response 


2- No exception is thrown 

3- Applet sends a display text 


4- SW = 69 85 


14 


Non-shareable files (FileView - ADF) 

1- Trigger the applet 

2- ADFlFileViewl. select DFiest, 
ADFlFileViewl . select ( ) EFhosh 

4- Select AID of ADFl, select DFiest, select 
EFnosh 

5- Fetch and terminal response 


2- No exception is thrown 

3- Applet sends a display text 


4- SW = 69 85 


15 


Non-Shareable files (MF - UlCCFileView) 

1- Reset 

2- Select DFiest, Select EFhosh 

3- Trigger the applet 

4- UICCFileViewl. select DFiest, 
UICCFileViewl . select ( ) EFhosh 


4- 

UICCException.lNTERNAL_ERRO 
R is thrown or 

UlCCException.FILE NOT FOUN 
D 


2- SW = 90 00 
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16 


Non-shareable files (ADF - FileView) 

1- Reset 








2- Select AID of ADFl, select DFtest, select 
EFnosh 




2- SW = 90 00 




3- Trigger the applet 








4- ADFlFileViewl. select DFjest, 


4- 






ADFlFileViewl . select ( ) EFhosh 


UICCException.lNTERNAL_ERRO 
R is thrown or 

UlCCException.FILE NOT FOUN 
D 




17 


Terminated EF/DF 

1- Reset 

2- Trigger the applet 








3- UICCAdminFileViewl. select DFiest, 
UICCAdminFileViewl . select ( ) EFierm 


3- No exception is tlirown 






4- UICCAdminFileViewl. select DFiest, 








UICCAdminFileViewl . select { ) DFjerm 


4- No exception is thrown 
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5.2 Package uicc.toolkit 



5.2.1 Interface EditHandler 

Tests are done in inheriting interfaces EnvelopeResponseHandler and ProactiveHandler. 

5.2.2 Interface EnvelopeHandler 
5.2.2.1 Method getltem Identifier 

Test Area Reference: Api_2_Enh_Giid 

5.2.2.1.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public byte getltemldentif ier ( ) 

throws ToolkitException 

5.2.2.1.1.1 Normal execution 

• CRRNl:The method shall return the item identifier byte value. 

• CRRN2:The item identifier byte value returned shall be from the first Item Identifier TLV element. 

• CRRN3: If the element is available it becomes the TLV selected. 

• CRRN4: The item identifier is available for all triggered toolkit applets from the invocation to the termination 
of their processTooMt method if the EnvelopeHandler is available. 



5.2.2.1.1.2 

No requirements. 

5.2.2.1.1.3 



Parameter errors 



Context errors 



• CRRC 1 : The method shall throw ToolkitException.UNAVAILABLE_ELEMENT if the item identifier TLV is 
not present. 

• CRRC2: The method shall throw ToolkitException.OUT_OF_TLV_BOUND ARIES if the item identifier byte 
is missing in the Item Identifier Comprehension TLV. 



5.2.2.1.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.2.1.3 



Test area files 

Test_Api_2_Enh_Giid.j ava. 
Api_2_Enh_Giid_ Lj ava. 
api_2_enh_giid.cap. 

Test coverage 



CRR number 


Test case number 


N1 


1,2,3 


N2 


2,3 


N3 


4 


N4 


6 


C1 


5 


C2 


7 
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5.2.2.1.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send envelope Menu Selection with item 
identifier TLV and identifier value of 03 


Returns 03 




2 


Send envelope Menu Selection with two item 
identifier TLV with first value 02 and 
second 01 


Returns 02 




3 


Send envelope Menu Selection with two item 
identifier TLV with first value 04 and 
second 01, call twice the method 
getltemldentif ier {) 


Returns 04 
Returns 04 




4 


Send envelope Menu Selection with item 
identifier TLV and value of 66. FindTLVO 
with TAG 02. getltemldentif ier ( ) and then 
getValueByte with offset 


getltemldentifier()=getValueByte() 




5 


Send unrecognized envelope without item 
identifier TLV and getltemldentif ier () 


ToolkitException. UNAVAILABLE E 
LEMENT 




6 


Send Envelope Menu Selection with item 
identifier TLV (66), send proactive 
command. Then getltemldentif ier ( ) 


Returns 66 




7 


Send Unrecognized Envelope with item 
identifier TLV but without item number 


ToolkitException.OUT OF TLV B 
OUNDARIES 





5.2.2.2 Method getLength 

Test Area Reference: Api_2_Enh_Glen. 

5.2.2.2.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getLength () 

throws ToolkitException 

5.2.2.2.1.1 Normal execution 

• CRRNl : returns the length in bytes of the TLV list. 

5.2.2.2.1 .2 Parameter errors 
No requirements. 

5.2.2.2.1 .3 Context errors 

• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

5.2.2.2.2 Test area files 

Specific triggering: Unrecognized envelope: 
Test Source: Test_Api_2_Enh_Glen.java. 
Test Applet: Api_2_Enh_Glen_l.java. 

Cap File: api_2_enh_glen.cap. 



5.2.2.2.3 



Test coverage 



CRR number 


Test case number 


N1 


1,2,3,4 


01 


Not testable 
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5.2.2.2.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send an Unrecognized Envelope with BER length 
of 0x31 


Result of getLengthO is 0x0031 




2 


Send an Unrecognized Envelope with BER length 
of 0x7F 


Result of getLengthO is 0x007Fh 




3 


Send an Unrecognized Envelope with BER length 
of 81 80 


Result of getLengthO is OxOOSOh 




4 


Send an Unrecognized Envelope with BER length 
of 81 FC 


Result of getLengthO is OxOOFCh 





5.2.2.3 Method copy 

Test Area Reference: Api_2_Enh_Copy. 



5.2.2.3.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

public short copy (byte [] dstBuffer, 
short dstOffset, 
short dstLength) 
throws Java . lang . NullPointerException, 

Java .lang . Array I ndexOut Of Bounds Exception^ 
ToolkitException 

5.2.2.3.1.1 Normal execution 

• CRRNl: copies the Comprehension TLV list contained in the handler to the destination byte array. 

• CRRN2: returns dstOffset + dstLength. 

5.2.2.3.1 .2 Parameter errors 

• CRRP 1 : if dstBuffer is null a NullPointerException is thrown. 

• CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative, 
an ArraylndexOutOfBoundsException is thrown. 

• CRRP3: if dstLength is greater than the length of the Comprehension TLV List, an instance of 
ToolkitException shall be thrown. The reason code shall be 
ToolkitException.OUT_OF_TLV_BOUND ARIES. 



5.2.2.3.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

5.2.2.3.2 Test area files 

Specific triggering: Unrecognized Envelope: 
Test Source: Test_Api_2_Enh_Copy.java. 
Test Applet: Api_2_Enh_Copy_l.java. 

Cap File: api_2_enh_copy.cap. 
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5.2.2.3.4 



Test coverage 



CRR number 


Test case number 


N1 


9, 11, 13, 15 


N2 


8, 10, 12, 14, 16 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7 


C1 


Not testable 



5.2.2.3.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


NULL as parameter to dstBuffer 


NullPointerException is thrown 




2 


dstOffset > dstBuffer.length 

copy 

dstBuffer.length = 5 
dstOffset = 5 
dstLength = 1 


ArraylndexOutOfBoundsException is 
tlirown 




3 


dstOffset < 

copy 

dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsException is 
tlirown 




4 


dstLength > dstBuffer.length 

copy 

dstBuffer.length = 5 
dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsException is 
thrown 




5 


DstOffset + dstLength > dstBuffer.length 

copy 

DstBuffer.length = 5 
DstOffset = 3 
DstLength = 3 


ArraylndexOutOfBoundsException is 
thrown 




6 


dstLength < 

copy 

dstBuffer.length = 5 
dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsException is 
thrown 




7 


DstLength > length of the Comprehension TLV 
list 

copy 

DstBuffer.length = 48 
DstOffset = 
DstLength = 48 


ToolkitException.OUT OF TLV BO 
UNDARIES is thrown 




8 


Successful call, dstBuffer is the whole buffer 

copy 

DstBuffer.length = 47 
DstOffset = 
DstLength = 47 


Result of copyO is 0X0047 




9 


Compare the buffer 


Result of arrayCompareO is 




10 


Successful call, dstBuffer is part of a buffer 

copy 

DstBuffer.length = 50 
dstOffset = 3 
dstLength = 47 


Result of copyO is 0X0032 




11 


Compare the whole buffer 


Result of arrayCompareO is 




12 


Successful call, dstBuffer is part of a buffer 

copy 

dstBuffer.length = 252 
dstOffset = 3 
dstLength = 252 


Result of copyO is OXOOFF 




13 


Compare the whole buffer 


Result of arrayCompareO is 




14 


Successful call, dstBuffer is part of a buffer 

copy 

dstBuffer.length = 260 
dstOffset = 257 
dstLength = 3 


Result of copyO is 0X01 04 




15 


Compare the whole buffer 


Result of arrayCompareO is 
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Id 


Description 


API Expectation 


APDU Expectation 


16 


Successful call, copy() with length =0 

dstBuffer. length = 260 
dstOffset = 260 
dstLength = 


Result of copyO is 0x104 





5.2.2.4 Method findTLV 

Test Area Reference: Api_2_Enh_Find. 

5.2.2.4.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte findTLV (byte tag, 

byte occurrence) 
throws ToolkitException 

5.2.2.4.1.1 Normal execution 

Looks for the indicated occurrence of a TLV element from the beginning of the TLV list (handler buffer): 

• CRRNl: the method is successful if the required occurrence exists then the corresponding TLV becomes 
current. 

• CRRN2: if the method is successful then it returns TLV_FOUND_CR_SET when Comprehension Required 
flag is set. 

• CRRN3: if the method is successful then it returns TLV_FOUND_CR_NOT_SET when Comprehension 
Required flag is not set. 

• CRRN4: if the required occurrence of the TLV element does not exist, the current TLV is no longer defined 
and TLV_NOT_FOUND is returned. 

• CRRN5: The search method is comprehension required flag independent. 

5.2.2.4.1 .2 Parameter errors 

• CRRP 1 : if an input parameter is not valid (e.g. occurrence = 0) an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException.BAD_INPUT_PARAMETER. 



5.2.2.4.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

5.2.2.4.2 Test area files 

Specific triggering: Unrecognized Envelope: 
Test Source: Test_Api_2_Enh_Find.java. 
Test Applet: Api_2_Enh_Find_l.java. 

Cap File: api_2_enh_find.cap. 
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5.2.2.4.3 



Test coverage 



CRR number 


Test case number 


N1 


3,5 


N2 


2,4 


N3 


10, 11 


N4 


6, 7, 8, 9 


N5 


12, 13 


P1 


1 


C1 


Not testable 



5.2.2.4.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 




Trigger the applet with Unrecognized Envelope 

including: 

Tag 82, tag 86, tag 8B, tag 02 and tag 04 






1 


Invalid Input parameter 

findTLVO 
Occurrence = 


ToolkitException.BAD_INPUT_PA 
RAIVIETER is thrown 




2 


SearchlstTLV 

findTLVO 
Tag = 02h 
Occurrence = 1 


Result is TLV_FOUND_CR_SET 




3 


Call the getValueLengthO method 


Result is 0x02 




4 


Search 2nd TLV 

findTLVO 
Tag = 06h 
Occurrence = 1 


Result is TLV_FOUND_CR_SET 




5 


Call the getValueLengthO method 


Result is 0x05h 




6 


Select a TLV (tag 02h) 
Search a wrong tag 

findTLVO 
Tag = 03h 
Occurrence = 1 


Result is TLV_NOT_FOUND 




7 


Call the getValueLengthO method 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown. 




8 


Search a tag with wrong occurrence 

findTLVO 
Tag = 02h 
Occurrence = 3 


Result is TLV_NOT_FOUND 




9 


Call the getValueLengthO method 


ToolkitException. UNAVAILABLE 
ELEIVIENT is thrown. 




10 


Search the TLV 

findTLVO 
Tag = 02h 
Occurrence = 2 


Result is 
TLV_FOUND_CR_NOT_SET 




11 


Search the TLV 

findTLVO 
Tag = 04h 
Occurrence = 1 


Result is 
TLV_FOUND_CR_NOT_SET 




12 


Search tag 86h 

findTLVO 
Tag = 86h 
Occurrence = 1 


Result is TLV_FOUND_CR_SET 




13 


Search tag 84h 

findTLVO 
Tag = 84h 
Occurrence = 1 


Result is 
TLV_FOUND_CR_NOT_SET 
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5.2.2.5 Method getValueLength 

Test Area Reference: Api_2_Enh_Gvle. 

5.2.2.5.1 Conformance requirement 

The method with following header shall be compliant to its definition in the APT 

public short getValueLength ( ) 

throws ToolkitException 



5.2.2.5.1.1 



Normal execution 



CRRNl: gets and returns the binary length of the value field for the last TLV element which has been found in 
the handler. 



5.2.2.5.1.2 

No requirements. 

5.2.2.5.1.3 



Parameter errors 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

• CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException.UNAVAILABLE_ELEMENT. 

5.2.2.5.2 Test area files 

Specific triggering: Unrecognized Envelope: 
Test source: Test_Api_2_Enh_Gvle.java. 

Test Applet: Api_2_Enh_Gvle_l.java. 

Cap File: api_2_enh_gvle.cap. 



5.2.2.5.3 



Test coverage 



CRR number 


Test case number 


N1 


2,3,4 


C1 


Not testable 


C2 


1 



5.2.2.5.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 




Fill the Unrecognized envelope with TLV: Tag 02, 
length 02, Tag 06, length 05, Tag OB, length 24, 
Tag 33, Length 08 






1 


getValueLengthO 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown 




2 


Search TLV 02h 

getValueLength ( ) 


Result is 0X0002 




3 


Search TLV OBh 

getValueLength ( ) 


Result is 0X0024 




4 


Search TLV 33h 

getValueLength ( ) 


Result is 0X00C8 
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5.2.2.6 Method getValueByte 

Test Area Reference: Api_2_Enh_Gvby. 

5.2.2.6.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte getValueByte (short valueOffset) 
throws ToolkitException 



5.2.2.6.1.1 



Normal execution 



CRRNl: Gets a byte from the last TLV element which has been found in the handler and returns its value 

(1 byte). 



5.2.2.6.1.2 



Parameter errors 



• CRRP 1 : if valueOffset is out of the current TLV an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException.OUT_OF_TLV_BOUND ARIES. 



5.2.2.6.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

• CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException.UNAVAILABLE_ELEMENT. 

5.2.2.6.2 Test area files 

Specific triggering: Unrecognized Envelope: 

Test Source: Test_Api_2_Enh_Gvby.java. 
Test Applet: Api_2_Enh_Gvby_l.java. 

Cap File: api_2_enh_gvby.cap. 



5.2.2.6.3 



Test coverage 



CRR number 


Test case number 


N1 


3, 4, 5, 6, 7, 8 


P1 


2 


C1 


Not testable 


C2 


1 



5.2.2.6.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 




Fill the Unrecognized envelope with TLV: Tag 02, 
length 02, value 83 81 , Tag 06, length 06, Tag OB, 
length 21, Tag 33, Length C8 Value 01 02 ... 






1 


getValueByte (0) 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown 




2 


Search TLV 02ii 

getValueByte (2) 






ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




3 


Search TLV 02h 








getValueByte (1) 


Result is 0x81 




4 


Search TLV 02h (Device Identities TLV) 








getValueByte (0) 


Result is 83h (Source) 
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Id 


Description 


API Expectation 


APDU Expectation 


5 


Search TLV 33h 








getValueByte(7E) 


Result is 0x7F 




6 


Search TLV 33h 








getValueByte(80) 


Result is 0x81 




7 


getValueByte (7F) 


Result is 0x80 




8 


Search TLV B3h 








getValueByte (C7) 


Result is 0xC8 





5.2.2.7 Method copyValue 

Test Area Reference: Api_2_Enh_Cpyv. 

5.2.2.7.1 Conformance requirement 

The method with following header shall be compliant with its definition in the API. 

public short copyValue (short valueOffset, 

byte[] dstBuffer, 
short dstOffset, 
short dstLength) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException^ 
ToolkitException 

5.2.2.7.1.1 Normal execution 

• CRRNl : copies a part of the last TLV element which has been found, into a destination, buffer. 

• CRRN2: returns dstOffset + dstLength. 

5.2.2.7.1 .2 Parameter errors 

• CRRP 1 : if dstBuffer is null NullPointerException is thrown. 

• CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative 
ArraylndexOutOfBoundsException is thrown. 

• CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException.OUT_OF_TLV_BOUND ARIES. 



5.2.2.7.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

• CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException.UNAVAILABLE_ELEMENT. 

5.2.2.7.2 Test area files 

Specific triggering: Unrecognized Envelope: 
Test Source: Test_Api_2_Enh_Cpyv.java. 
Test Applet: Api_2_Enh_Cpyv_Ljava. 

Cap File: api_2_enh_cpyv.cap. 
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5.2.2.7.3 



Test coverage 



CRR number 


Test case number 


N1 


13,15 


N2 


12, 14, 16 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7,8,9, 10 


C1 


Not testable 


C2 


11 



5.2.2.7.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Search TLV 02h 








copyValueO with a null dstBuffer 


NullPointerException is thrown 




2 


Search TLV OBh 








dstOffset > dstBuffer.length 

copyValue () 
dstBuffer.length = 5 
dstOffset = 5 
dstLength = 1 


Array 1 ndexOutOfBou ndsExceptio 
n is thrown 




3 


dstOffset < 

copyValue () 
dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


dstLength >dstBuffer.length 

copyValue () 
dstBuffer.length = 5 
dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + dstLength >dstBuffer.length 

copyValue {) 
dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


dstLength < 

copyValue ( ) 
dstBuffer.length = 5 
dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Search TLV 06h 








valueOffset > TLV Length 

copyValue {) 
valueOffset = 6 
dstBuffer.length = 15 
dstOffset = 
dstLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

copyValue () 
valueOffset = -1 
dstBuffer.length = 15 
dstOffset = 
dstLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


dstLength > TLV length 

copyValue () 
valueOffset = 
dstBuffer.length = 15 
dstOffset = 
dstLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


valueOffset + dstLength > TLV length 

copyValue () 
valueOffset = 2 
dstBuffer.length = 15 
dstOffset = 
dstLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


11 


Search TLV 01 h 








copyValue () 


ToolkitException.UNAVAILABLE_ 
ELEMENT is thrown on the 
copyValueQ method call. 




12 


Search TLV 06h 








Successful call 

copyValue () 
valueOffset = 
dstBuffer .length = 6 
dstOffset = 
dstLength = 6 


Result of copyValueO is 0x0006 




13 


Compare buffer 

buffer = 81 11 22 33 44 F5 


Result is OOh 




14 


initialize dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

copyValue {) 
valueOffset = 1 
dstBuffer. length = 20 
dstOffset = 3 
dstLength = 4 


Result of copyValueO is 0x0007 




15 


Compare buffer 

buffer = 
55 55 55 11 22 
33 44 55 55 55 
55 55 55 55 55 
55 55 55 55 55 


Result is OOh 




16 


Successful call, copy with length =0 

dstBuffer .length = 20 
dstOffset = 20 
dstLength = 


Result of copyValueO is 20 





5.2.2.8 Method compareValue 

Test Area Reference: Api_2_Enh_Cprv. 

5.2.2.8.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte compareValue (short valueOffset, 

byte[] compareBuf fer, 
short compareOf f set, 
short compareLength) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
ToolkitException 

5.2.2.8.1.1 Normal execution 

Compares the last found TLV element with a buffer: 

• CRRN 1 : returns if identical. 

• CRRN2: returns -1 if the first miscomparing byte in Comprehension TLV List is less than that in 
compareBuffer. 

• CRRN3: returns 1 if the first miscomparing byte in Comprehension TLV List is greater than that in 
compareBuffer. 



ETSI 



Release 6 



124 



ETSI TS 102 268 V6.0.0 (2007-03) 



5.2.2.8.1.2 Parameter errors 

• CRRPl: if compareBuffer is null NullPointerException shall be thrown. 

• CRRP2: if compareOffset or compareLength or both would cause access outside array bounds, or if 
compareLength is negative ArraylndexOutOfBoundsException shall be thrown. 

• CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException.OUT_OF_TLV_BOUND ARIES. 



5.2.2.8.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

• CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException.UNAVAILABLE_ELEMENT. 

5.2.2.8.2 Test area files 

Specific triggering: Unrecognized Envelope: 
Test Source: Test_Api_2_Enh_Cprv.java. 
Test Applet: Api_2_Enh_Cprv_l.java. 

Cap File: api_2_enh_cprv.cap. 



5.2.2.8.3 



Test coverage 



CRR number 


Test case number 


N1 


12, 15, 18 


N2 


13, 14, 17 


N3 


16 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7,8,9, 10 


C1 


Not testable 


C2 


11 



5.2.2.8.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Search TLV 02ii 








compareValue with a null compareBuffer 


NullPointerException is thrown 




2 


Search TLV OBh 








compareOffset > compareBuffer.length 


Array 1 ndexOutOfBou ndsExceptio 






compareValue ( ) 


n is thrown 






compareBuffer.length = 5 








compareOffset = 5 








compareLength = 1 






3 


compareOffset < 


ArraylndexOutOfBoundsExceptio 






compareValue () 


n is thrown 






compareBuffer.length = 5 








compareOffset = -1 








compareLength = 1 






4 


compareLength >compareBuffer.length 


ArraylndexOutOfBoundsExceptio 






compareValue ( ) 


n is thrown 






compareBuffer.length = 5 








compareOffset = 








compareLength = 6 
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Id 


Description 


API Expectation 


APDU Expectation 


5 


compareOffset + compareLength 
>compareBuffer.length 

compareValue () 
compareBuffer . length = 5 
compareOffset = 3 
compareLength = 3 


Array 1 ndexOutOfBou ndsExceptio 
n is thrown 




6 


compareLength < 

compareValue () 
compareBuffer . length = 5 
compareOffset = 
compareLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Search TLV 06h 








valueOffset > TLV Length 

compareValue ( ) 
valueOffset = 6 
compareBuffer . length = 15 
compareOffset = 
compareLength = 1 


Tooll<itException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

compareValue ( ) 
valueOffset = -1 
compareBuffer . length = 15 
compareOffset = 
compareLength = 1 


Tooll<itException.OUT OF TLV 
BOUNDARIES is thrown 




9 


compareLength > TLV length 

compareValue ( ) 
valueOffset = 
compareBuffer . length = 15 
compareOffset = 
compareLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


valueOffset + compareLength > TLV length 

compareValue ( ) 
valueOffset = 2 
compareBuffer . length = 15 
compareOffset = 
compareLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Search TLV 01 h 


Result is TLV NOT FOUND 






compareValue () 


ToolkitException.UNAVAILABLE_ 
ELEMENT is thrown 




12 


Search TLV 06h 








Initialize compareBuffer 

compareBuffer = 
81 11 22 33 44 F5 








Compare buffers 

compareValue () 
valueOffset = 
compareOffset = 
compareLength = 6 


Result is OOh 




13 


Initialize compareBuffer 

compareBuffer = 
7F 11 22 33 44 F5 








Compare buffers with same parameters 


Result is -1 




14 


Initialize compareBuffer 

compareBuffer = 
83 11 22 33 44 F5 








Compare buffers with same parameters 


Result is -1 




15 


Initialize compareBuffer 

compareBuffer = 

55 55 55 81 11 22 33 44 F5 

55 55 55 55 55 








Compare buffers 

compareValue ( ) 
valueOffset = 1 
compareOffset = 4 
compareLength = 5 


Result is OOh 




16 


Initialize compareBuffer 

compareBuffer = 

55 55 55 81 10 23 33 44 F5 

55 55 55 55 55 








Compare buffers with same parameters 


Result is +1 
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Id 


Description 


API Expectation 


APDU Expectation 


17 


Initialize compareBuffer 

compareBuf f er = 

55 55 55 81 12 21 33 44 F5 

55 55 55 55 55 








Compare buffers with same parameters 


Result is -1 




18 


Successful call, compareValue() with length=o 

CompareBuf fer . length = 15 
CompareOf f set = 15 
CompareLength = 


Result of compareValueO is 





5.2.2.9 Method findAndCopyValue(byte tag, byte[] dstBuffer, short dstOffset) 

Test Area Reference: Api_2_Enh_Facyb_Bs. 

5.2.2.9.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short f indAndCopyValue (byte tag, 

byte[] dstBuffer, 
short dstOffset) 
throws Java . lang . NullPointerException, 

Java .lang . Array I ndexOut Of Bounds Except ion, 
ToolkitException 



5.2.2.9.1.1 



Normal execution 



• CRRNl: looks for the first occurrence of a TLV element from the beginning of a TLV list and copy its value 
into a destination buffer. 

• CRRN2: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current 
TLV is no longer defined. 

• CRRN3: if the method is successful then the corresponding TLV becomes current and dstOffset + length of 
the copied value is returned. 

• CRRN4: The search method is comprehension required flag independent. 

5.2.2.9.1 .2 Parameter errors 

• CRRPl: if dstBuffer is null NullPointerException shall be thrown. 

• CRRP2: if dstOffset would cause access outside array bounds ArraylndexOutOfBoundsException shall be 
thrown. 



5.2.2.9.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

5.2.2.9.2 Test area files 

Specific triggering: Unrecognized Envelope: 

Test Source: Test_Api_2_Enh_Facyb_Bs.java. 
Test Applet: Api_2_Enh_Facyb_Bs_Ljava. 

Cap File: api_2_enh_facyb_bs.cap. 
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5.2.2.9.3 



Test coverage 



CRR number 


Test case number 


N1 


9, 11, 13 


N2 


6,7 


N3 


8, 10, 12 


N4 


14, 15, 16, 17 


P1 


1 


P2 


2, 3, 4, 5 


C1 


Not testable 



5.2.2.9.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 




Fill the Unrecognized Envelope with TLV: Tag 

02, Value 83 81 , Tag 06, Value 81 1 1 22 33 44 

F5, Tag 02 Value 22 44 Tag 33, Length C4 

Value 01 02... 






1 


FindAndCopyValueO with a null dstBuffer 


NullPointerException is thrown 




2 


dstOffset > dstBuffer.length 

findAndCopyValue () 
tag = 06h 

dstBuffer.length = 06 
dstOffset = 06 


ArraylndexOutOfBoundsExceptio 
n is ttirown 




3 


dstOffset < 

findAndCopyValue () 
dstBuffer.length = 06 
dstOffset = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


length > dstBuffer.length 

findAndCopyValue () 
dstBuffer.length = 05 
dstOffset = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


DstOffset + length >dstBuffer.length 

findAndCopyValue () 
DstBuffer.length = 06 
DstOffset = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


Select a TLV (tag 02h) 








findAndCopyValueO 

tag = 03h 


Tooll<itException.UNAVAILABLE_ 
ELEMENT is thrown 




7 


Call the getValueLengthO method 


Tooll<itException. UNAVAILABLE 
ELEIVIENT is thrown. 




8 


Successful call 

findAndCopyValue () 
Tag = 06h 

DstBuffer.length = 06 
DstOffset = 


Result of findAndCopyValue {) is 
0006 




9 


Compare buffer 

buffer = 81 11 22 33 44 F5 


Result is OOh 




10 


Initialize dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

findAndCopyValue () 
dstBuffer.length = 12 
dstOffset = 2 


Result of findAndCopyValue () is 
0008 




11 


Compare buffer 

buffer = 

55 55 81 11 22 33 44 F5 55 55 55 55 


Result is OOh 




12 


Successful call 

findAndCopyValue () 
tag = 02h 

dstBuffer.length = 2 
dstOffset = 


Result of findAndCopyValue {) is 
0002 




13 


Compare buffer 

buffer = 83 81 


Result is OOh 
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Id 


Description 


API Expectation 


APDU Expectation 


14 


Successful call (with tag 82h) 

f indAndCopyValue () 
tag = 82h 

dstBuffer. length = 02 
dstOffset = 


Result of fincJAndCopyValue () is 
0002 




15 


Compare buffer 

buffer = 83 81 


Result is OOh 




16 


Successful call (with tag B3h) 

f IndAndCopyValue () 
tag = B3h 

dstBuffer. length = C4 
dstOffset = 


Result of fincJAndCopyValue () is 
00C4 




17 


Compare buffer 

buffer = 01 02 ... C4 


Result is OOh 





5.2.2.1 Method findAndCopyValue(byte tag, byte occurrence, short valueOffset, 
byte[] dstBuffer, short dstOffset, short dstLength) 

Test Area Reference: Api_2_Enh_Facybs_Bss. 



5.2.2.10.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

public short f IndAndCopyValue (byte tag, 

byte occurrence, 
short valueOffset, 
byte[] dstBuffer, 
short dstOffset, 
short dstLength) 
throws Java . lang . NullPointerException, 

Java . lang. ArraylndexOutOfBoundsException, 
Toolkit Except ion 



5.2.2.10.1.1 



Normal execution 



• CRRNl : looks for the indicated occurrence of a TLV element from the beginning of a TLV list and copy its 
value into a destination buffer. 

• CRRN2: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current 
TLV is no longer defined. 

• CRRN3: if the method is successful then the corresponding TLV becomes current and dstOffset + dstLength is 
returned. 

• CRRN4: The search method is comprehension required flag independent. 

5.2.2.10.1.2 Parameter errors 

• CRRPl : if dstBuffer is null NullPointerException shall be thrown. 

• CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative 
ArraylndexOutOfBoundsException shall be thrown. 

• CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException.OUT_OF_TLV_BOUNDARIES. 

• CRRP4: if an input parameter is not valid (e.g. occurrence = 0) an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException.BAD_INPUT_PARAMETER. 



5.2.2.10.1.3 



Context errors 



CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 
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5.2.2.10.2 Test area files 

Specific triggering: Unrecognized Envelope: 

Test Source: Test_Api_2_Enh_Facybs_Bss.java. 
Test Applet: Api_2_Enh_Facybs_Bss_l.java. 

Cap File: api_2_enh_facybs_bss.cap. 



5.2.2.10.3 



Test coverage 



CRR number 


Test case number 


N1 


14, 15, 17, 19,20 


N2 


11, 12 


N3 


13, 15, 17, 19,25 


N4 


21,22,23,24 


P1 


1 


P2 


2,3,4,5,6 


P3 


7,8,9, 10 


P4 


26 


C1 


Not testable 



5.2.2.10.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 




Fill the Unrecognized Envelope with TLV: Tag 

02, Value 83 81 , Tag 06, Value 81 1 1 22 33 44 

F5, Tag 02 Value 22 44 Tag 33, Length C4 

Value 01 02... 






1 


findAndCopyValueO with a null dstBuffer 


NullPointerException is thrown 




2 


dstOffset > dstBuffer.length 

f IndAndCopyValue {) 

tag = 06h, occurrence = 1 

valueOffset = 

dstBuffer.length = 5 

dstOffset = 5 

dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


dstOffset < 

f IndAndCopyValue () 
dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


dstLength >dstBuffer.length 

f indAndCopyValue () 
dstBuffer.length = 5 
dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + dstLength >dstBuffer.length 

f IndAndCopyValue () 
dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


dstLength < 

f IndAndCopyValue () 
dstBuffer.length = 5 
dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


valueOffset > Value Length 

f IndAndCopyValue () 

tag = 06h, occurrence = 1 

valueOffset = 6 

dstBuffer.length = 15 

dstOffset = 

dstLength = 1 


Tooll<itException.OUT OF TLV 
BOUNDARIES is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


8 


valueOffset < 

f IndAndCopyValue () 
valueOffset = -1 
dstBuffer .length = 15 
dstOffset = 
dstLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


dstLength > Value length 

f IndAndCopyValue () 
valueOffset = 
dstBuffer .length = 15 
dstOffset = 
dstLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


valueOffset + dstLength > Text String length 

f IndAndCopyValue () 
valueOffset = 2 
dstBuffer .length = 15 
dstOffset = 
dstLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Select a TLV (tag 02h) 








findAndCopyValueO 

tag = 06h 
occurrence = 2 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown 




12 


Call the getValueLengthO method 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown. 




13 


Successful call 

f IndAndCopyValue () 

tag = 06h, occurrence = 1 

valueOffset = 

dstBuffer .length = 06 

dstOffset = 

dstLength = 06 


Result of findAndCopyValueQ is 6 




14 


Compare buffer 

buffer = 81 11 22 33 44 F5 


Result is OOh 




15 


Initialize dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

f IndAndCopyValue () 

tag = 06h, occurrence = 1 

valueOffset = 2 

dstBuffer. length = 12 

dstOffset = 3 

dstLength = 04 


Result of findAndCopyValue () is 
0007 




16 


Compare buffer 

buffer = 

55 55 55 22 33 44 F5 55 55 55 55 55 


Result is OOh 




17 


Successful call 

f IndAndCopyValue () 

tag = 02h, occurrence = 1 

valueOffset = 

dstBuffer .length = 12 

dstOffset = 

dstLength = 2 


Result of findAndCopyValueQ is 
0002 




18 


Compare buffer 

buffer = 83 81 55 ... 55 


Result is OOh 




19 


Successful call 

f IndAndCopyValue () 

tag = 02h, occurrence = 2 

valueOffset = 

dstBuffer .length = 12 

dstOffset = 

dstLength = 2 


Result of findAndCopyValueQ is 
0002 




20 


Compare buffer 

buffer = 22 44 55 ... 55 


Result is OOh 




21 


Successful call (with tag 82h) 

f IndAndCopyValue () 
tag = 82h 
occurrence = 1 
valueOffset = 
dstBuffer. length = 12 
dstOffset = 
dstLength = 02 


Result of findAndCopyValue () is 
0002 




22 


Compare buffer 

buffer = 83 81 55 ... 55 


Result is OOh 
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Id 


Description 


API Expectation 


APDU Expectation 


23 


Successful call (with tag 82h) 

f IndAndCopyValue () 
tag = 82h 
occurrence = 2 
valueOffset = 
dstBuffer. length = 12 
dstOffset = 
dstLength = 02 


Result of finclAndCopyValue () is 
0002 




24 


Compare buffer 

Buffer = 22 44 55 ... 55 


Result is OOh 




25 


Successful call, findAndCopyValue() with 
length =0 

DstBuffer .length = 12 
dstOffset = 12 
dstLength = 


Result of fincJAndCopyValue () is 
12 




26 


Invalid parameter 

f IndAndCopyValue () 
occurrence = 


ToolkitException.BAD_INPUT_PA 
RAIVIETER is thrown 





5.2.2.1 1 Method findAndCompareValue(byte tag, byteQ compareBuffer, short 

compareOffset) 

Test Area Reference: Api_2_Enh_Facrb_Bs. 

5.2.2.1 1.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte f indAndCompareValue (byte tag, 

byte[] compareBuffer, 
short compareOffset) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
ToolkitException 

5.2.2.11.1.1 Normal execution 

Looks for the first occurrence of a TLV element from beginning of a TLV list and compare its value with a buffer: 

• CRRNl: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current 
TLV is no longer defined. 

• CRRN2: if the method is successful then the corresponding TLV becomes current. 

• CRRN3: if identical returns 0. 

• CRRN4: if the first miscomparing byte in Comprehension TLV is less than that in compareBuffer returns -1. 

• CRRN5: if the first miscomparing byte in Comprehension TLV is greater than that in compareBuffer returns 1. 

• CRRN6: The search method is comprehension required flag independent. 

5.2.2.11.1.2 Parameter errors 

• CRRPl: if compareBuffer is null NullPointerException shall be thrown. 

• CRRP2: if compareOffset would cause access outside array bounds ArraylndexOutOfBoundsException shall 
be thrown. 



5.2.2.11.1.3 



Context errors 



CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 
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5.2.2.11.2 Test area files 

Specific triggering: Unrecognized Envelope: 

Test Source: Test_Api_2_Enh_Facrb_Bs.java. 
Test Applet: Api_2_Enh_Facrb_Bs_l.java. 

Cap File: api_2_enh_facrb_bs.cap. 



5.2.2.11.3 



Test coverage 



CRR number 


Test case number 


N1 


6,7 


N2 


9 


N3 


8, 12, 13 


N4 


11, 15 


N5 


10, 14 


N6 


16, 17 


P1 


1 


P2 


2, 3, 4, 5 


C1 


Not testable 



5.2.2.11.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 




Fill the Unrecognized Envelope with TLV: Tag 

02, Value 83 81 , Tag 06, Value 81 1 1 22 33 44 

F5, Tag 02 Value 22 44 Tag 33, Length C4 

Value 01 02... 






1 


findAndCompareValueO with a null dstBuffer 


NullPointerException is thrown 




2 


compareOffset > compareBuffer.length 

f indAndCompareValue () 
tag = 06h 

compareBuffer.length = 12 
compareOffset = 12 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


compareOffset < 

f IndAndCompareValue () 
compareBuffer.length = 12 
compareOffset = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


length > compareBuffer.length 

f IndAndCompareValue () 
compareBuffer.length = 05 
compareOffset = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


compareOffset + length > 
compareBuffer.length 

f IndAndCompareValue () 
compareBuffer.length = 12 
compareOffset = 7 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


Select a TLV (tag 02h) 








findAndCompareValueO 

tag = 03h 


Tooll<itException. UNAVAILABLE 
ELEMENT is thrown 




7 


Call the getValueLengthO method 


Tooll<itException. UNAVAILABLE 
ELEIVIENT is thrown. 




8 


Initialize compareBuffer 

compareBuffer = 81 11 22 33 44 F5 








Compare buffers 

f IndAndCompareValue () 
tag = 06h 
compareOffset = 


Result is OOh 




9 


Verify current TLV 

getValueLength ( ) 


Result is 06 




10 


Initialize compareBuffer 

compareBuffer = 81 11 22 33 44 F4 








Compare buffers with same parameters 


Result is +1 
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Id 


Description 


API Expectation 


APDU Expectation 


11 


Initialize compareBuffer 

compareBuffer = 81 11 22 33 44 F6 








Compare buffers with same parameters 


Result is -1 




12 


Initialize compareBuffer 

compareBuffer = 

55 55 81 11 22 33 44 F5 55 55 55 55 








Compare buffers 

f IndAndCompareValue () 
compareOf f set = 2 


Result is OOh 




13 


Initialize compareBuffer 

compareBuffer = 

55 55 83 81 55 55 55 55 55 55 55 55 








Compare buffers 

f IndAndCompareValue () 
compareOf f set = 2 


Result is OOh 




14 


Initialize compareBuffer 

compareBuffer = 

55 55 83 80 55 55 55 55 55 55 55 55 








Compare buffers 

f IndAndCompareValue () 
compareOf f set = 2 


Result is +1 




15 


Initialize compareBuffer 

compareBuffer = 

55 55 83 82 55 55 55 55 55 55 55 55 








Compare buffers 

f IndAndCompareValue () 
compareOf f set = 2 


Result is -1 




16 


Initialize compareBuffer 

compareBuffer = 

83 81 55 55 55 55 55 55 55 55 55 55 








Successful call (with tag 02h) 

f IndAndCompareValue () 
tag = 02h 

compareBuff er . length = 12 
compareOf f set = 


Result is OOh 




17 


Initialize compareBuffer 

CompareBuffer = 01 02 ... C4 








Successful call (with tag B3h) 

f IndAndCompareValue () 
Tag = B3h 

CompareBuffer . length = C4 
CompareOf f set = 


Result is OOh 





5.2.2.12 Method findAndCompareValue(byte tag, byte occurrence, short valueOffset, 
byte[] compareBuffer, short compareOffset, short compareLength) 

Test Area Reference: Api_2_Enh_Facrbbs_Bss. 



5.2.2.12.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

public byte f IndAndCompareValue (byte tag, 

byte occurrence, 
short valueOffset, 
byte[] compareBuffer, 
short compareOffset, 
short compareLength) 
throws Java . lang. NullPointerException, 

Java .lang . Array I ndexOut Of Bounds Except ion. 
Toolkit Except ion 
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5.2.2.12.1.1 



Normal execution 



Looks for the indicated occurrence of a TLV element from the beginning of a TLV Hst and compare its value with a 
buffer: 

• CRRNl : if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current 
TLV is no longer defined. 

• CRRN2: if the method is successful then the corresponding TLV becomes current. 

• CRRN3: if identical is returned. 

• CRRN4: if the first miscomparing byte in Comprehension TLV is less than that in compareBuffer -1 is 
returned. 

• CRRN5: if the first miscomparing byte in Comprehension TLV is greater than that in compareBuffer 1 is 
returned 

• CRRN6: The search method is comprehension required flag independent. 

5.2.2.12.1.2 Parameter errors 

• CRRPl: if compareBuffer is null NullPointerException shall be thrown. 

• CRRP2: if compareOffset or compareLength or both would cause access outside array bounds, or if 
compareLength is negative ArraylndexOutOfBoundsException shall be thrown. 

• CRRP3: if valueOffset, compareLength or both are out of the current TLV an instance of ToolkitException 
shall be thrown. The reason code shall be ToolkitException.OUT_OF_TLV_BOUND ARIES. 

• CRRP4: if an input parameter is not valid (e.g. occurrence = 0) an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException.BAD_INPUT_PARAMETER. 



5.2.2.12.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

5.2.2.12.2 Test area files 

Specific triggering: Unrecognized Envelope: 

Test Source: Test_Api_2_Enh_Facrbbs_Bss.java. 
Test Applet: Api_2_Enh_Facrbbs_Bss_Ljava. 

Cap File: api_2_enh_facrbbs_bss.cap. 



5.2.2.12.3 



Test coverage 



CRR number 


Test case number 


N1 


12, 13 


N2 


15 


N3 


14, 18,21,22,26 


N4 


17, 19,23 


N5 


16,20 


N6 


24,25 


PI 


1 


P2 


2, 3, 4, 5, 6 


P3 


7,8,9, 10 


P4 


11 


CI 


Not testable 



ETSI 



Release 6 



135 



ETSI TS 102 268 V6.0.0 (2007-03) 



5.2.2.12.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 




Fill the Unrecognized Envelope with TLV: Tag 

02, Value 83 81 , Tag 06, Value 81 1 1 22 33 44 

F5, Tag 02 Value 22 44 Tag 33, Length C4 

Value 01 02... 






1 


findAndCompareValueO with a null 
compareBuffer 


NullPointerException is thrown 




2 


compareOffset > compareBuffer.length 

f indAndCompareValue () 
tag = 06h, occurrence = 1 
valueOffset = 
compareBuffer.length = 6 
compareOffset = 6 
compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


compareOffset < 

f IndAndCompareValue () 
compareBuffer.length = 6 
compareOffset = -1 
compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


compareLength >compareBuffer.length 

f IndAndCompareValue () 
compareBuffer.length = 5 
compareOffset = 
compareLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


compareOffset + compareLength 
>compareBuffer.length 

f IndAndCompareValue () 
compareBuffer.length = 5 
compareOffset = 3 
compareLength = 3 


Array 1 ndexOutOfBou ndsExceptio 
n is thrown 




6 


compareLength < 

f indAndCompareValue () 
compareBuffer.length = 5 
compareOffset = 
compareLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


valueOffset > Value Length 

f IndAndCompareValue () 
tag = 06h, occurrence = 1 
valueOffset = 6 
compareBuffer.length = 15 
compareOffset = 
compareLength = 1 


Tooll<itException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

f IndAndCompareValue ( ) 
valueOffset = -1 
compareBuffer.length = 15 
compareOffset = 
compareLength = 1 


Tooll<itException.OUT OF TLV 
BOUNDARIES is thrown 




9 


compareLength > Value length 

f IndAndCompareValue () 
valueOffset = 
compareBuffer.length = 15 
compareOffset = 
compareLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


valueOffset + compareLength > Value length 

f IndAndCompareValue () 
valueOffset = 2 
compareBuffer.length = 15 
compareOffset = 
compareLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Invalid parameter 

f IndAndCompareValue ( ) 
occurrence = 


ToolkitException.BAD_INPUT_PA 
RAIVIETER is thrown 




12 


Select a TLV (tag 02h) 








findAndCompareValueO 

tag = 06h 
occurrence = 2 


ToolkitException.UNAVAILABLE_ 
ELEMENT is thrown 




13 


Call the getValueLengthO method 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown. 
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Id 


Description 


API Expectation 


APDU Expectation 


14 


Initialize compareBuffer 

compareBuffer = 81 11 22 33 44 F5 








findAndCompareValueQ 

tag = 06h, occurrence = 1 
valueOffset = 
compareOf f set = 
compareLength = 6 


Result is OOh 




15 


Verify current TLV 

getValueLength ( ) 


Result is 0006 




16 


Initialize compareBuffer 

compareBuffer = 81 11 22 33 44 F4 








Compare buffers with same parameters 


Result is +1 




17 


Initialize compareBuffer 

compareBuffer = 81 11 22 33 44 F6 








Compare buffers with same parameters 


Result is -1 




18 


Initialize compareBuffer 

compareBuffer = 

55 55 55 22 33 44 F5 55 55 55 55 








Compare buffers 

f IndAndCompareValue () 
valueOffset = 2 
compareOf f set = 3 
compareLength = 4 


Result is OOh 




19 


Initialize compareBuffer 

compareBuffer = 

55 55 55 22 33 45 F5 55 55 55 55 








Compare buffers with same parameters 


Result is -1 




20 


Initialize compareBuffer 

compareBuffer = 

55 55 55 22 33 43 F5 55 55 55 55 








Compare buffers with same parameters 


Result is +1 




21 


Initialize compareBuffer 

compareBuffer = 

83 81 55 55 55 55 55 55 55 55 55 55 








findAndCompareValueQ 

tag = 02h, occurrence = 1 
valueOffset = 
compareOf f set = 
compareLength = 2 


Result is OOh 




22 


Initialize compareBuffer 

compareBuffer = 

22 44 55 55 55 55 55 55 55 55 55 55 








findAndCompareValueQ 

tag = 02h, occurrence = 2 
valueOffset = 
compareOf f set = 
compareLength = 2 


Result is OOh 




23 


Initialize compareBuffer 

compareBuffer = 

22 45 55 55 55 55 55 55 55 55 55 55 








findAndCompareValueQ 

tag = 02h, occurrence = 2 
valueOffset = 
compareOf fset = 
compareLength = 2 


Result is -1 




24 


Initialize compareBuffer 

compareBuffer = 

83 81 55 55 55 55 55 55 55 55 55 55 








Successful call (with tag 02h) 

f IndAndCompareValue {) 
tag = 02h, occurrence = 1 
valueOffset = 
compareBuff er . length = 12 
compareOf fset = 
compareLength = 2 


Result is OOh 
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Id 


Description 


API Expectation 


APDU Expectation 


25 


Initialize compareBuffer 

compareBuf fer = 01 02 ... C4 








Successful call (with tag B3h) 

f IndAndCompareValue () 
tag = B3h, occurrence = 1 
valueOffset = 
compareBuf fer . length = 00C4 
compareOf f set = 
compareLength = 00C4 


Result is OOh 




26 


Successful call, findAndCompareValue() with 
length =0 

DstBuf fer .length = C4 
DstOffset = C4 
DstLength = 


Result of findAndCompareValueO 
is OOh 





5.2.2.13 Method getCapacity 

Test Area Reference: Api_2_Enh_Gcap. 

5.2.2.13.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte getCapacity ( ) 

5.2.2.13.1.1 Normal execution 

• CRRNl : The method shall return the maximum size of the Comprehension TLV list managed by the handler. 

5.2.2.13.1.2 Parameter errors 
No requirements 

5.2.2.13.1.3 Context errors 

• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AV AIL ABLE. 



5.2.2.13.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.2.13.3 



Test area files 

Test_Api_2_Enh_Gcap.java. 
Api_2_Enh_Gcap_l .Java. 
api_2_enh_gcap . cap . 

Test coverage 



CRR number 


Test case number 


N1 


1 


C1 


Not testable 
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5.2.2.13.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


EnvelopeHandler available 

1 - Send envelope Menu Selection 

2 - The applet calls the getLengthO 
method 

3 - The applet calls the getCapacity ( ) 
method 


1 - Applet is triggered 

2 - No exception is thrown 

3 - No exception is tlirown; tlie 
capacity is greater than the BER 
TLV Length 





5.2.2.14 Method getChannelldentifier 

Test Area Reference: Api_2_Enh_Gcid. 

5.2.2.14.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte getChannelldentif ier ( ) 

throws ToolkitException 

5.2.2.14.1.1 Normal execution 

• CRRNl: The method shall return the channel identifier byte value. 

• CRRN2: The channel identifier byte value returned shall be from the first Channel status TLV element. 

• CRRN3: If the element is available it becomes the currently selected TLV. 

• CRRN4: The channel identifier is available for all triggered toolkit applets from the invocation to the 
termination of their processToolkit method if the EnvelopeHandler is available. 

5.2.2.14.1 .2 Parameter errors 
No requirements 

5.2.2.14.1.3 Context errors 

• CRRC 1 : The method shall throw ToolkitException.UNAVAILABLE_ELEMENT if the Channel status TLV 
is not present. 

• CRRC2: The method shall throw ToolkitException.OUT_OF_TLV_BOUND ARIES if the Comprehension 
TLV Channel Status length is equal to 0. 



5.2.2.14.2 

Test Source: 
Test Applet: 
Cap File: 



Test area files 

Test_Api_2_Enh_Gcid.j ava. 
Api_2_Enh_Gcid_l .Java. 
api_2_enh_gcid.cap. 
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5.2.2.14.3 



Test coverage 



CRR number 


Test case number 


N1 


1,2 


N2 


2 


N3 


3 


N4 


5 


C1 


4 


C2 


6 



5.2.2.14.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





1- Appletl is installed with maximum number of 
channel = 07 . 

2- Appletl builds proactive commands OPEN CHANNEL 
with initO method in order to open all channels. 
ProactiveHandler . send {) method is called. 




2- OPEN CHANNEL 
proactive command is 
fetched 

TERMINAL RESPONSE is 
issued with Channel Id 
from 01 to 07 


1 


Successful Call 

1- Send envelope Event Download Channel Status 
with channel status TLV: 

channel status value = 0x8100. 

2- Call EnvelopeHandler . getChannelldentif ier ( ) 
method 


1- Appletl is triggered 
2- Returns 0x01 




2 


Two channel status elements 

1- Send envelope Event Download Channel Status 
with two channel status TLV: 

first value = 0x8400 
second value = 0x8500. 

2- Call twice the 

EnvelopeHandler . getChannelldentif ier () method 


2- Returns twice 0x04 




3 


Verify current TLV 

1- Send envelope Event Download Channel Status 
with channel status TLV: 

Channel Status value = 0x0605 

ViewHandler .FindTLVO with Device IdentityTag. 

2- Call EnvelopeHandler . getChannelldentif ier ( ) 

method. 

3- Compare EnvelopeHandler .getChannelldentif ier () 
and then ViewHandler .getValueByte (0) . 


2- Returns 0x06 

3- GetChannelldentifierQ 
=getValueByte(0) 




4 


UNAVAILABLE_ELEMENT exception 

1- Send envelope Menu Selection without Channel 
Status TLV. 

2- Call EnvelopeHandler .getChannelldentif ier 

method. 


2- A Tooll<it 

exception. UNAVAILABLE 
ELEMENT is thrown. 




5 


Successful Call 

1- Send Envelope Event Download Channel Status 
with Channel Status TLV: 

Channel status value = 0x0600 

2- Call EnvelopeHandler . getChannelldentif ier ( ) 
method. 


1 - Returns 0x06 
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Id 


Description 


API Expectation 


APDU Expectation 


6 


OUT_OF_TLV_BOUNDARIES exception 

1- Send unrecognized envelope with a Channel 
Status TLV having a length equal to . 

2- Call EnvelopeHandler .getChannelldentif ier 
method. 


2- A Toolkit 

exception.OUT OF TLV 
BOUNDARIES is thrown. 





5.2.2.15 Method getChannelStatus 

Test Area Reference: Api_2_Enh_Gcst. 

5.2.2.15.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getChannelStatus (byte channelldentif ier) 

throws ToolkitException 

5.2.2.15.1.1 Normal execution 

• CRRNl: The method shall return the value of the first Channel Status TLV element. 

• CRRN2: The Channel Status value returned shall be from the element whose channel identifier is equal to the 
Channelldentifier parameter. 

• CRRN3: If the element is available it becomes the currently selected TLV. 

• CRRN4: The channel status is available for all triggered toolkit applets from the invocation to the termination 
of their processToolkit method if the EnvelopeHandler is available. 

5.2.2.1 5.1 .2 Parameter errors 
No requirements. 

5.2.2.15.1.3 Context errors 

• CRRC 1 : The method shall throw ToolkitException.UNAVAILABLE_ELEMENT if no Channel Status TLV 
element with the right identifier could be found. 

• CRRC2: The method shall throw ToolkitException.OUT_OF_TLV_BOUND ARIES if a Channel Status TLV 
element with the right identifier could be found but its value is less than 2 bytes long. 



5.2.2.15.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.2.15.3 



Test area files 

Test_Api_2_Enh_Gcst.j ava. 
Api_2_Enh_Gcst_l .Java. 
api_2_enh_gcst.cap. 

Test coverage 



CRR number 


Test case number 


N1 


6 


N2 


5 


N3 


7 


N4 


8 


CI 


1,2 


C2 


3,4 
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5.2.2.15.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





1- Appletl is installed with maximum 
number of channel = 01. 

2- Appletl builds proactive commands OPEN 
CHANNEL with initO method in order to 
open a channel . 

ProactiveHandler . send ( ) method is called. 




2- OPEN CHANNEL 
proactive command is 
fetched 

TERMINAL RESPONSE is 
issued with channel status 
value = 0x8100 


1 


Channel status TLV is not present 

1- Send envelope Event Download Channel 
Status with no Channel status TLV 

2- Call 

EnvelopeHandler .getChannelStatus (0x01) 
method. 


2- UNAVAILABLE_ELEMENT 
ToolkitException is thrown 




2 


Channel status TLV with the identifier is not 
present 

1- Send envelope Event Download Channel 
Status with Channel status Value = 0x8200 

2- Call 

EnvelopeHandler .getChannelStatus (0x01) 
method. 


2- UNAVAILABLE_ELEMENT 
ToolkitException is thrown 




3 


Channel status TLV with a length equal to 

1- Send envelope Event Download Channel 
Status with Channel status length equal 
to . 

2- Call 

EnvelopeHandler .getChannelStatus (0x01) 
method. 


2- UNVAILABLE_ELEMENT 
ToolkitException is thrown 




4 


Channel status TLV with a length equal to 1 

1- Send envelope Event Download Channel 
Status with Channel status length equal 
to 1. 

2- Call 

EnvelopeHandler .getChannelStatus (0x01) 
method. 


2- OUT_OF_TLV_BOUNDARIES 
ToolkitException is thrown 




5 


Get channel status value 

1- Send envelope Event Download Channel 
Status with Channel status value=0x8100 . 

2- Call 

EnvelopeHandler .getChannelStatus (0x01) 
method. 


2- Returns 0x8100 




6 


Get channel status value with 2 TLV 

1- Send envelope Event Download Channel 
Status with 2 channel status value: 
0x8100 and 0x8101. 

2- Call 

EnvelopeHandler .getChannelStatus (0x01) 
method. 


2- Returns 0x8100 
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Id 


Description 


API Expectation 


APDU Expectation 


7 


Channel status TLV is currently selected TLV 

1- Send envelope Event Download Channel 
Status with channel status value 0x8100. 
Call ViewHandler.FindTLVO method with 
Device Identity Tag. 

2- Call 

EnvelopeHandler . getChannelStatus (0x01 ) 
method. 

3- Compare 

EnvelopeHandler .getChannelStatus (0x01) 
and ViewHandler .getValueShort (0) method 
results . 


2- Returns 0x8100 

3- Check getChannelStatus() 
=getValueShort{0) 




8 


Get channel status value after a proactive 
command 

1- Send envelope Event Download Channel 
Status with Channel status value=0x8100 . 

2- Call 

EnvelopeHandler .getChannelStatus (0x01) 
method. 

3- Send a proactive command display text 

4- Call 

EnvelopeHandler .getChannelStatus (0x01) 
method. 


2- Returns 0x8100 
4- Returns 0x8100 


3- DISPLAY TEXT proactive 
command is fetched 

TERMINAL RESPONSE is 
issued 



5.2.2.16 Method getValueShort 

Test Area Reference: Api_2_Enh_Gvsh. 

5.2.2.16.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getValueShort (short valueOffset) 
throws ToolkitException 



5.2.2.16.1.1 



Normal execution 



• CRRN 1 : Gets a short from the last TLV element which has been found in the handler and returns its value 
(1 short). 



5.2.2.16.1.2 



Parameter errors 



CRRPl: if valueOffset is out of the current TLV an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException.OUT_OF_TLV_BOUND ARIES. 



5.2.2.16.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

• CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException.UNAVAILABLE_ELEMENT. 
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5.2.2.16.2 Test area files 

Specific triggering: Unrecognized Envelope: 
Test Source: Test_Api_2_Enh_Gvsh.java. 
Test Applet: Api_2_Enh_Gvsh_l.java. 

Cap File: api_2_enh_gvsh.cap. 



5.2.2.16.3 



Test coverage 



CRR number 


Test case number 


N1 


3, 4, 5, 6, 7, 8 


P1 


2 


C1 


Not testable 


C2 


1 



5.2.2.16.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 




Fill the Unrecognized envelope with TLVs : 
Tag 02, Length 02 Value 83 81 
Tag 06, Length 06 Value 81 11 22 33 44 F5 
Tag 33, Length C9 Value 01 02 ... 






1 


getValueShort (0) 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown 




2 


Search TLV 02h 








getValueShort (2) 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




3 


Search TLV 02h 








getValueShort (0) 


Result is 0x83 0x81 




4 


Search TLV 06h 








getValueShort (1) 


Result is 0x1 1 0x22 




5 


Search TLV 33h 








getValueShort (7E) 


Result is 0x7F 0x80 




6 


Search TLV 33h 








getValueShort (80) 


Result is 0x81 0x82 




7 


getValueShort (7F) 


Result is 0x80 0x81 




8 


Search TLV B3h 








getValueShort (C7) 


Result is OxC8 0xC9 





5.2.2.17 Method getSize 

Test Area Reference: Api_2_Enh_Gtsz. 

5.2.2.17.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public short getSize() 

5.2.2.17.1.1 Normal execution 

• CRRNl: Returns the BER TLV size, this includes the tag and the length. 

5.2.2.17.1.2 Parameter errors 
No requirements. 
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5.2.2.17.1.3 Context errors 

No requirements. 

5.2.2.17.2 Test area files 

Specific triggering: Unrecognized Envelope: 

Test Source: Test_Api_2_Enh_Gtsz.java. 

Test Applet: Api_2_Enh_Gtsz_l.java. 

Cap File: api_2_enh_gtsz.cap. 



5.2.2.17.3 



Test coverage 



CRR number 


Test case number 


1 


1,2 



5.2.2.17.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Send an unrecognized envelope of length 
0x33 (including tag and length) 






1 


Call getSizeO method just after 
triggering of the application. 


Returns 0x33 




2 


Call getSizeO method after a proactive 

command. 


Returns 0x33 





5.2.2.18 Method getlag 

Test Area Reference: Api_2_Enh_Gttg. 

5.2.2.18.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getTag() 

5.2.2.18.1.1 Normal execution 

• CRRN 1 : Returns the BER Tag of the BER TLV list. 

5.2.2.18.1.2 Parameter errors 
No requirements. 

5.2.2.18.1.3 Context errors 
No requirements. 

5.2.2.18.2 Test area files 

Specific triggering: Unrecognized Envelope: 
Test Source: Test_Api_2_Enh_Gttg.java. 
Test Applet: Api_2_Enh_Gttg_l.java. 

Cap File: api_2_enh_gttg.cap. 
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5.2.2.18.3 



Test coverage 



CRR number 


Test case number 


1 


1,2 



5.2.2.18.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Send an unrecognized envelope 






1 


Call getTagO method just after 
triggering of the application. 


Returns OxXX 




2 


Call getTagO method after a proactive 
command. 


Returns OxXX 





5.2.3 Interface EnvelopeResponseHandler 
5.2.3.1 Method post 

Test Area Reference: Api_2_Erh_Post. 

5.2.3.1.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void post (boolean value) 

throws ToolkitException 

5.2.3.1.1.1 Normal execution 

• CRRNl: The toolkit applet can continue its processing after the call to post() method. 

• CRRN2: In case of CALL_CONTROL, the CAT Runtime Environment has to set the boolean value always to 
true. 

• CRRN3: The CAT Runtime Environment shall send the response before the emission of the next proactive 
command or when all the Toolkit Applets triggered by the event have finished their processing. 

• CRRN4: The CAT Runtime Environment has to map the boolean value to the correct status word. If the value 
is true it corresponds to a successful ending of the command status word "9000". If the value is false it 
corresponds to a warning status word "6200". 

5.2.3.1.1.2 Parameter errors 
No requirements. 

5.2.3.1.1.3 Context errors 

• CRRC 1 : The method shall throw ToolkitException.HANDLER_NOT_AVAILABLE if the handler is busy. 

• CRRC2: The method shall throw ToolkitException.B AD_LENGTH if the resulting response length is greater 
than 256 and the response data has to be retrieved by the GET RESPONSE command. 

5.2.3.1.2 Test area files 

Specific triggering: Unrecognized envelope: 
Test Source: Test_Api_2_Erh_Post.java. 
Test Applet: Api_2_Erh_Post_l.java. 

Cap File: api_2_erh_post.cap. 
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5.2.3.1.3 



Test coverage 



CRR number 


Test case number 


N1 


3,4,7 


N2 


8,9 


N3 


4,5 


N4 


1,2,4,7 


C1 


3,6,7 


C2 


1 (see note) 


NOTE: This test is conditional and automatically performed if the capacity of the 
envelopeResponseHandler is greater than 256 bytes. 



5.2.3.1.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


getTheHandlerO and then post() 

(the handler is empty) 




9000 


2 


Fill the handler (appendTLVO to have 
bytes in it) and then postO data with 
value TRUE 




FD data with status word 90 00 are 
returned 


3 


Verify that after a post the handler is no 
more available 

appendTLVO, then postO and then 
appendTLVO 


ToolkitException. HANDLER 
NOT_AVAILABLE is thrown 
on the second appendTLV 




4 


construct the response (appendTLVO with 

0x10 data) and post it with value FALSE and 

then send a display text 

1- Send an unrecognizedEnvelope () to 
trigger the applet. 

2- Send a 

envelopeEventDownloadUserActivity ( ) to 
get the 91 XX status word. 




1-12 data with status SW = 62 00 

2- SW = 91 15 is returned and display 
text is retrieved by a FETCH 


5 


Verify that it is possible to send a proactive 
command after a post() 

getTheHandlerO and postO, then send a 
display text 

1- Send an unrecognizedEnvelope () to 
trigger the applet . 

2- Send a 

envelopeEventDownloadUserActivity () to 
get the 91 XX status word. 




1-SW = 62 00 

2- SW = 91 1 5 is returned and display 
text is retrieved by a FETCH 


6 


Verify it is not possible to post after a 
proactive command 

getTheHandlerO, appendTLVO, send a 
display text and then postO . 


ToolkitException. HANDLER 
NOT_AVAILABLE is thrown 




7 


Verify that the handler is no more available 
after a post() 

getTheHandlerO, appendTLVO, then 
postO with value FALSE and then postO 
with value TRUE 


ToolkitException. HANDLER 
NOT_AVAILABLE is thrown 


1 2 data with status word 62 00 are 
returned 


8 


CALL_CONTROL, the CAT Runtime 

Environment set the boolean value always 

to true 

Trigger the applet with CALL CONTROL 
getTheHandlerO, appendTLVO, postO 
with value FALSE 




1 2 data with status word 90 00 are 
returned 


9 


CALL_CONTROL, the CAT Runtime 

Environment set the boolean value always 

to true 

Trigger the applet with CALL CONTROL 
getTheHandlerO, appendTLVO, postO 
with value TRUE 




1 2 data with status word 90 00 are 
returned 


10 


Resulting response length greater than 256 

getTheHandlerO, appendTLVO (data 
length 252 bytes), appendTLV () (data 
length 1 byte), post () with value TRUE 


javacard.framework.APDUEx 
ception.BAD_LENGTH is 
thrown 
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5.2.3.2 Method postAsBERTLV 

Test Area Reference:Api_2_Erh_Poab. 

5.2.3.2.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void postAsBERTLV ( boolean value, 

byte tag) 
throws ToolkitException 

5.2.3.2.1.1 Normal execution 

CRRNl: The toolkit applet can continue its processing after the call to postAsBERTLV() method. 

CRRN2: In case of CALL_CONTROL, the CAT Runtime Environment has to set the boolean value always to 
true. 

CRRN3: The CAT Runtime Environment shall send the response before the emission of the next proactive 
command or when all the Toolkit Applets triggered by the event have finished their processing. 

CRRN4: The byte tag is the BER Tag at the beginning of the Comprehension TLV list. 

CRRN5: The CAT Runtime Environment has to map the Boolean value to the correct status word. If the value 
is true it corresponds to a successful ending of the command status word "9000". If the value is false it 
corresponds to a warning status word "6200". 

5.2.3.2.1 .2 Parameter errors 
No requirements. 

5.2.3.2.1 .3 Context errors 

• CRRC 1 : The method shall thrown ToolkitException.H ANDLER_NOT_AV AILABLE if the handler is busy. 

• CRRC2: The method shall throw ToolkitException.B AD_LENGTH if the resulting response length is greater 
than 256 and the response data has to be retrieved by the GET RESPONSE command. 

5.2.3.2.2 Test area files 

Specific triggering: Unrecognized envelope: 
Test Source: Test_Api_2_Erh_Poab.java. 
Test Applet: Api_2_Erh_Poab_l.java. 

Cap File: api_2_erh_poab.cap. 



5.2.3.2.3 



Test coverage 



CRR number 


Test case number 


N1 


3,4,7 


N2 


8,9 


N3 


4,5 


N4 


2,4,7 


N5 


1,2,4,7 


C1 


3,6,7 


C2 


10 
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5.2.3.2.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


getTheHandlerO and then postAsBERTLV() 

(the handler is empty) 




02 data with status word 90 
00 are returned, the tag shall 
be 33 and the length is 00 


2 


Fill the handler and then postAsBERTLV() 
the data with value TRUE, and tag 33 




FF data with status word 90 
00 are returned, the tag shall 
be 33 


3 


appendTLVO, postAsBERTLVQ and then 
appendTLVQ 


ToolkitException.HANDLER_NOT_AV 
AILABLE is thrown on the second 
appendTLV 




4 


construct the response (appendTLV() with 
0x10 data) and postAsBERTLV() with value 
FALSE, tag 75 and then send a display text 

1- Send an unrecognizedEnvelope () to 
trigger the applet . 

2- Send a 

envelopeEventDownloadUserActivity () to 
get the 91 XX status word. 




1- 14 data with status SW = 
62 00 

2-SW = 91 15 is returned 
and display text is retrieved 
by a FETCH 


5 


getTheHandlerO and postAsBERTLVQ with 
value FALSE, then send a display text 

1- Send an unrecognizedEnvelope () to 
trigger the applet. 

2- Send a 

envelopeEventDownloadUserActivity () to 
get the 91 XX status word. 




1- 02 data are returned with 
status SW = 62 00 

2-SW = 91 15 is returned 
and display text is retrieved 
by a FETCH 


6 


Verify it is not possible to postAsBERTLVQ 
after a proactive command 

getTheHandlerO, appendTLVO, send a 
display text and then postAsBERTLV { ) . 


ToolkitException.HANDLER_NOT_AV 
AILABLE is thrown on the 
postAsBERTLV 




7 


Verify that the handler is no more available 
after a postAsBERTLVQ 

getTheHandlerO, appendTLV () (with data 
length = 0x10, then postAsBERTLV ( ) with 
value FALSE, tag 56 and then 
postAsBERTLV with value TRUE, tag 28 


Tooll<itException.HANDLER_NOT_AV 
AILABLE is thrown on the second 
postAsBERTLV 


1 4 data with status word 62 
00 are returned, the tag shall 
be 56 


8 


CALL_CONTROL, the CAT Runtime 

Environment set the boolean value always 

to true 

Trigger the applet with CALL CONTROL 
getTheHandlerO, appendTLVO, 
postAsBERTLV with value FALSE 




1 2 data with status word 90 
00 are returned 


9 


CALL_CONTROL, the CAT Runtime 

Environment set the boolean value always 

to true 

Trigger the applet with CALL CONTROL 
getTheHandlerO, appendTLVO, 
postAsBERTLV with value TRUE 




1 2 data with status word 90 
00 are returned 


10 


Resulting response length greater than 256 

getTheHandlerO, appendArray () (255 
bytes), postAsBERTLV with value TRUE 


javacard.framework.APDUException. 
BAD_LENGTH is thrown 
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5.2.3.3 Method getLength 

Test Area Reference: Api_2_Erh_Glen. 

5.2.3.3.1 Conformance requirement 

The method with following header shall be compliant to its definition in the APT 

public short getLength () 

throws ToolkitException 

5.2.3.3.1.1 Normal execution 

• CRRNl : returns the length in bytes of the TLV list. 

5.2.3.3.1 .2 Parameter errors 
No requirements. 

5.2.3.3.1.3 Context errors 

• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

5.2.3.3.2 Test area files 

Specific triggering: Unrecognized Envelope: 
Test Source: Test_Api_2_Erh_Glen.java. 
Test Applet: Api_2_Erh_Glen_l.java. 

Cap File: api_2_erh_glen.cap. 



5.2.3.3.3 



Test coverage 



CRR number 


Test case number 


N1 


1,2,3,4,5 


C1 


6 



5.2.3.3.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Clear the handler 

getLength ( ) 


Result of getLengthO is 




2 


appendTLVO with length of 7 

getLength {) 


Result of getLengthO is 9 




3 


Clear the handler and appendTLVQ with 
Length of getCapacity()-3 

getLength () 


Result of getLengthO is 
getCapacity()-3 




4 


Build a 7Fh Envelope response handler 

getLength ( ) 


Result of getLengthO is 81 h 




5 


Build a 80h Envelope response handler 
getLengthO 


Result of getLengthO is 83h 




6 


HANDLER_NOT_AVAILABLE exception 

Call postO method, then getLengthO 


ToolkitException. HANDLER NOT 
AVAILABLE is thrown 
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5.2.3.4 Method copy 

Test Area Reference: Api_2_Erh_Copy. 

5.2.3.4.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short copy (byte [] dstBuffer, 
short dstOffset, 
short dstLength) 
throws Java . lang.NullPointerException, 

Java . lang. ArraylndexOutOfBoundsException, 
Toolkit Except ion 

5.2.3.4.1.1 Normal execution 

• CRRNl: copies the Comprehension TLV list contained in the handler to the destination byte array. 

• CRRN2: returns dstOffset + dstLength. 

5.2.3.4.1 .2 Parameter errors 

• CRRPl : if dstBuffer is null a NullPointerException is thrown. 

• CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative, 
an ArraylndexOutOfBoundsException is thrown. 

• CRRP3: if dstLength is greater than the length of the Comprehension TLV List, an instance of 
ToolkitException shall be thrown. The reason code shall be 
ToolkitException.OUT_OF_TLV_BOUND ARIES. 



5.2.3.4.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AV AIL ABLE. 

5.2.3.4.2 Test area files 

Specific triggering: Unrecognized Envelope: 
Test Source: Test_Api_2_Erh_Copy.java. 
Test Applet: Api_2_Erh_Copy_l.java. 

Cap File: api_2_erh_copy.cap. 



5.2.3.4.3 



Test coverage 



CRR number 


Test case number 


N1 


9, 11, 13 


N2 


8, 10, 12, 14 


P1 


1 


P2 


2,3,4,5,6 


P3 


7 


C1 


15 
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5.2.3.4.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


appendTLVQ with value length of 7 
NULL as parameter to dstBuffer 


NullPointerException is thrown 




2 










dstOffset > dstBuffer.length 

copy 

dstBuffer.length = 5 
dstOffset = 5 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


dstOffset < 

copy 

dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


dstLength > dstBuffer.length 

copy 

dstBuffer.length = 5 
dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + dstLength > dstBuffer.length 

copy 

dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


dstLength < 

copy 

dstBuffer.length = 5 
dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


dstLength > length of the Comprehension TLV 
list 

copy 

dstBuffer.length = 10 
dstOffset = 
dstLength = 10 


Tooll<itException.OUT OF TLV 
BOUNDARIES is thrown 




8 


Successful call, dstBuffer is the whole buffer 

copy 

dstBuffer.length = 9 
dstOffset = 
dstLength = 9 


Result of copyO is 9 




9 


Compare the buffer 


Result of arrayCompareO is 




10 


Successful call, dstBuffer is part of a buffer 

copy 

dstBuffer.length = 0x8F 
dstOffset = 3 
dstLength = 0x8C 


Result of copyO is 0x8F 




11 


Compare the whole buffer 


Result of arrayCompareO is 




12 


Successful call, dstBuffer is part of a buffer 

copy 

dstBuffer.length = 15 
dstOffset = 3 
dstLength = 6 


Result of copyO is 9 




13 


Compare the whole buffer 


Result of arrayCompareO is 




14 


Successful call, copy with length =0 

copy 

dstBuffer.length = 15 
dstOffset = 15 
dstLength = 


Result of copyO is 15 




15 


HANDLER_NOT_AVAILABLE exception 

Call post{) method, then copyQ 


ToolkitException. HANDLER NOT 
AVAILABLE is thrown 
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5.2.3.5 Method findTLV 

Test Area Reference: Api_2_Erh_Find. 

5.2.3.5.1 Conformance requirement 

The method with following header shall be compliant to its definition in the APT 

public byte findTLV (byte tag, byte occurrence) 
throws ToolkitException 

5.2.3.5.1.1 Normal execution 

Looks for the indicated occurrence of a TLV element from the beginning of the TLV list (handler buffer): 

• CRRNl: the method is successful if the required occurrence exists then the corresponding TLV becomes 
current. 

• CRRN2: if the method is successful then it returns TLV_FOUND_CR_SET when Comprehension Required 
flag is set. 

• CRRN3: if the method is successful then it returns TLV_FOUND_CR_NOT_SET when Comprehension 
Required flag is not set. 

• CRRN4: if the required occurrence of the TLV element does not exist, the current TLV is no longer defined 
and TLV_NOT_FOUND is returned. 

• CRRN5: The search method is comprehension required flag independent. 

5.2.3.5.1.2 Parameter errors 

• CRRP 1 : if an input parameter is not valid (e.g. occurrence = 0) an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException.BAD_INPUT_PARAMETER. 



5.2.3.5.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AV AIL ABLE. 

5.2.3.5.2 Test area files 

Specific triggering: Unrecognized Envelope: 
Test Source: Test_Api_2_Erh_Find.java. 
Test Applet: Api_2_Erh_Find_Ljava. 

Cap File: api_2_erh_fmd.cap. 



5.2.3.5.3 



Test coverage 



CRR number 


Test case number 


N1 


3,5 


N2 


2,4 


N3 


10, 11 


N4 


6, 7,8, 9 


N5 


12, 13 


P1 


1 


C1 


14 
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5.2.3.5.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


append the handler with TLVs: 

81 03 11 22 33 

82 02 99 77 








Invalid input parameter 

findTLVO 

Occurrence = 


ToolkitException.BAD_INPUT_PA 
RAMETER is thrown 




2 










Search 1st TLV 

findTLVO 
Tag = Olh 
Occurrence = 1 


Result is TLV_FOUND_CR_SET 




3 


Call the getValueLengthO method 


Result is 03h 




4 


Search 2nd TLV 

findTLVO 
Tag = 02h 
Occurrence = 1 


Result is TLV_FOUND_CR_SET 




5 


Call the getValueLengthO method 


Result is 02h 




6 


Select a TLV (tag 02h) 








Search a wrong tag 

findTLVO 
Tag = 03h 
Occurrence = 1 


Result is TLV_NOT_FOUND 




7 


Call the getValueLengthO method 


ToolkitException. UNAVAILABLE 
ELEIVIENT Is thrown. 




8 


Search a tag with wrong occurrence 

findTLVO 
Tag = Olh 
Occurrence = 2 


Result is TLV_NOT_FOUND 




9 


Call the getValueLengthO method 


ToolkitException. UNAVAILABLE, 
ELEMENT is thrown. 




10 


Append a TLV with tag=02h 








Search the TLV 

findTLVO 
Tag = 02h 
Occurrence = 2 


Result is 
TLV_FOUND_CR_NOT_SET 




11 


Append a TLV with tag=04h 








Search the TLV 

findTLVO 
Tag = 04h 
Occurrence = 1 


Result is 
TLV_FOUND_CR_NOT_SET 




12 


Search tag 81 h 

findTLVO 
Tag = 81h 
Occurrence = 1 


Result is TLV_FOUND_CR_SET 




13 


Search tag 84h 

findTLVO 
Tag = 84h 
Occurrence = 1 


Result is 
TLV_FOUND_CR_NOT_SET 




14 


HANDLER_NOT_AVAILABLE exception 

Call postO method, then findTLV() 


ToolkitException. HANDLER NOT 
AVAILABLE is thrown 





5.2.3.6 Method getValueLength 

Test Area Reference: Api_2_Erh_Gvle 

5.2.3.6.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getValueLength ( ) 

throws ToolkitException 
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5.2.3.6.1.1 



Normal execution 



• CRRNl: gets and returns the binary length of the value field for the last TLV element which has been found in 
the handler. 



5.2.3.6.1.2 

No requirements. 

5.2.3.6.1.3 



Parameter errors 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

• CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException.UNAVAILABLE_ELEMENT. 

5.2.3.6.2 Test area files 

Specific triggering: Unrecognized Envelope: 
Test Source: Test_Api_2_Erh_Gvle.java. 
Test Applet: Api_2_Erh_Gvle_l.java. 

Cap File: api_2_erh_gvle.cap. 



5.2.3.6.3 



Test coverage 



CRR number 


Test case number 


N1 


2, 3, 4, 5, 6 


C1 


7 


C2 


1 



5.2.3.6.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


appendTLVO 02 02 02 02 
findTLVO with TAG 03 








getValueLengthQ 


ToolkitException. UNAVAILABLE_ 
ELEMENT is thrown 




2 


appendTLVO with TAG OD and length 00 








Search TLV ODh 








getValueLength ( ) 


Result is OOh 




3 


Clear the handler and append TLV with TAG 
OD and length 02 








Search TLV ODh 








getValueLength ( ) 


Result is 02h 




4 


Clear the handler and appendTLVO with TAG 
OD and length 0x7F 








Search TLV ODh 








getValueLengthO 


Result is 7Fh 




5 


Clear the handler and appendTLVO with TAG 
OD and length 0x80 








Search TLV ODh 








getValueLength ( ) 


Result is 80h 





ETSI 



Release 6 



155 



ETSI TS 102 268 V6.0.0 (2007-03) 



Id 


Description 


API Expectation 


APDU Expectation 


6 


Clear the handler and appendTLV() with TAG 
CD and length OxFI 








Search TLV ODh 








getValueLength ( ) 


Result is F1h 




7 


HANDLER_NOT_AVAILABLE exception 

Call postO method, then getValueLength ( ) 


ToolkitException. HANDLER NOT 
AVAILABLE is thrown 





5.2.3.7 Method getValueByte 

Test Area Reference: Api_2_Erh_Gvby. 

5.2.3.7.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte getValueByte (short valueOffset) 
throws ToolkitException 



5.2.3.7.1.1 



Normal execution 



• CRRNl: Gets a byte from the last TLV element which has been found in the handler and returns its value 
(1 byte). 



5.2.3.7.1.2 



Parameter errors 



CRRPl: if valueOffset is out of the current TLV an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException.OUT_OF_TLV_BOUND ARIES. 



5.2.3.7.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AV AIL ABLE. 

• CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException.UNAVAILABLE_ELEMENT. 

5.2.3.7.2 Test area files 

Specific triggering: Unrecognized Envelope: 
Test Source: Test_Api_2_Erh_Gvby.java. 
Test Applet: Api_2_Erh_Gvby_l.java. 

Cap File: api_2_erh_gvby.cap. 



5.2.3.7.3 



Test coverage 



CRR number 


Test case number 


N1 


3, 4, 5, 6, 7, 8 


P1 


2 


C1 


9 


C2 


1 
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5.2.3.7.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


appendTLVO 82 02 81 82, appendTLV() 81 03 

11 22 FE 

fIndTLV with TAG 03 








getValueByte(O) 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown 




2 


Search TLV 01 h 








getValueByteO) 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




3 


Search TLV 01 h 








getValueByte(2) 


Result is FEh 




4 


Search TLV 02h 








getValueByte (0) 


Result is 81 h 




5 


appendTLVO with TAG OD, Length 0x7E, 
Value: 00, 01,..., 7D 








getValueByte (7D) 


Result is 7Dh 




6 


clear the handler, appendTLVO with TAG OD, 
Length 0x80, Value: 00, 01, ..., 7F 








getValueByte (7E) 


Result is 7Eh 




7 


getValueByte (7F) 


Result is 7Fh 




8 


Clear the handler, appendTLVO with TAG OD, 
Length OxFI, Value: 00, 01, ..., FO 








getValueByte (FO) 


Result is FOh 




9 


HANDLER_NOT_AVAILABLE exception 

Call postO method, then getValueByteO 


ToolkitException. HANDLER NOT 
AVAILABLE is thrown 





5.2.3.8 Method copyValue 

Test Area Reference: Api_2_Erh_Cpyv. 



5.2.3.8.1 



Conformance requirement 



The method with following header shall be compliant with its definition in the API. 

public short copyValue (short valueOffset, 

byte[] dstBuffer, 
short dstOffset, 
short dstLength) 
throws Java . lang . NullPointerException, 

Java .lang . Array IndexOutOfBoundsExcept ion, 
ToolkitException 

5.2.3.8.1.1 Normal execution 

• CRRNl : copies a part of the last TLV element which has been found, into a destination, buffer. 

• CRRN2: returns dstOffset + dstLength. 

5.2.3.8.1 .2 Parameter errors 

• CRRP 1 : if dstBuffer is null NullPointerException is thrown. 

• CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative 
ArraylndexOutOfBoundsException is thrown. 

• CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException.OUT_OF_TLV_BOUND ARIES. 
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5.2.3.8.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

• CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException.UNAVAILABLE_ELEMENT. 

5.2.3.8.2 Test area files 

Specific triggering: Unrecognized Envelope: 
Test Source: Test_Api_2_Erh_Cpyv.java. 
Test Applet: Api_2_Erh_Cpyv_l.java. 

Cap File: api_2_erh_cpyv.cap. 



5.2.3.8.3 



Test coverage 



CRR number 


Test case number 


N1 


13, 15 


N2 


12, 14, 16 


P1 


1 


P2 


2,3,4,5,6 


P3 


7,8,9, 10 


C1 


17 


C2 


11 



5.2.3.8.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


appendTLVQ with TAG: CD and length 16 
Select Text String TLV 








copyValue with a null dstBuffer 


NullPointerException is thrown 




2 










dstOffset > dstBuffer.length 

copyValue () 
dstBuffer.length = 5 
dstOffset = 5 
dstLength = 1 


Array 1 ndexOutOfBou ndsExceptio 
n is thrown 




3 


dstOffset < 

copyValue {) 
dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


dstLength >dstBuffer.length 

copyValue () 
dstBuffer.length = 5 
dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + dstLength >dstBuffer.length 

copyValue () 
dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


dstLength < 

copyValue () 
dstBuffer.length = 5 
dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


7 


clear the handler, appendTLV() with TAG: CD 

and length 6 

Select Text String TLV 








valueOffset > Text String Length 

copyValue () 
valueOffset = 6 
dstBuffer .length = 15 
dstOffset = 
dstLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

copyValue () 
valueOffset = -1 
dstBuffer .length = 15 
dstOffset = 
dstLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


dstLength > Text String length 

copyValue ( ) 
valueOffset = 
dstBuffer .length = 15 
dstOffset = 
dstLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


valueOffset + dstLength > Text String length 

copyValue ( ) 
valueOffset = 2 
dstBuffer .length = 15 
dstOffset = 
dstLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Initialize the handler 








copyValue () 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown 




12 


clear the handler, appendTLV() with TAG: CD 

and value: 04 00 01 ...OF 

Select Text String TLV 








Successful call 

copyValue () 
valueOffset = 
dstBuffer. length = 17 
dstOffset = 
dstLength = 17 


Result of copyValueO is 17 




13 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




14 


Initialize dstBuffer 

dstBuffer = 55 55 ... 55 

clear the handler 

AppendTLV with TAG OxOD and value 0x01 

0x02 ... 0x83 








Successful call 

copyValue () 
valueOffset = 2 
dstBuffer. length = 0x86 
dstOffset = 3 
dstLength = 0x81 


Result of copyValueO is 0x84 




15 


Compare buffer 

buffer = 

55 55 55 01 02 

03 04 05 06 07 

08 09 ... 81 

55 55 55 55 55 


Result is OOh 




16 


Successful call, copyValue() with length =0 

dstBuffer. length = 20 
dstOffset = 20 
dstLength = 


Result of copyValueO is 20 




17 


HANDLER_NOT_AVAILABLE exception 

Call post{) method, then copyValue{) 


ToolkitException. HANDLER NOT 
AVAILABLE is thrown 
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5.2.3.9 Method compareValue 

Test Area Reference: Api_2_Erh_Cprv. 

5.2.3.9.1 Conformance requirement 

The method with following header shall be compliant to its definition in the APT 

public byte compareValue (short valueOffset, 

byte[l compareBuf fer, 
short compareOf f set, 
short compareLength) 
throws Java . lang . NullPointerException, 

Java .lang . Array I ndexOut Of Bounds Except ion, 
ToolkitException 

5.2.3.9.1.1 Normal execution 
Compares the last found TLV element with a buffer: 

• CRRN 1 : returns if identical. 

• CRRN2: returns -1 if the first miscomparing byte in Comprehension TLV List is less than that in 
compareBuffer. 

• CRRN3: returns 1 if the first miscomparing byte in Comprehension TLV List is greater than that in 
compareBuffer. 

5.2.3.9.1 .2 Parameter errors 

• CRRPl : if compareBuffer is null NullPointerException shall be thrown. 

• CRRP2: if compareOffset or compareLength or both would cause access outside array bounds, or if 
compareLength is negative ArraylndexOutOfBoundsException shall be thrown. 

• CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException.OUT_OF_TLV_BOUNDARIES. 

5.2.3.9.1.3 Context errors 

• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AV AIL ABLE. 

• CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException. UNA VAILABLE_ELEMENT. 

5.2.3.9.2 Test area files 

Specific triggering: Unrecognized Envelope: 
Test Source: Test_Api_2_Erh_Cprv.java. 
Test Applet: Api_2_Erh_Cprv_Ljava. 

Cap File: api_2_erh_cprv.cap. 
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5.2.3.9.3 



Test coverage 



CRR number 


Test case number 


N1 


12, 15, 18 


N2 


13, 16 


N3 


14, 17 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7,8,9, 10 


C1 


19 


C2 


11 



5.2.3.9.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


appendTLVQ with TAG: CD and length 16 
Select Text String TLV 








compareValueQ with a null compareBuffer 


NullPointerException is thrown 




2 










compareOffset > compareBuffer.length 

compareValue () 
compareBuffer.length = 5 
compareOffset = 5 
compareLength = 1 


Array 1 ndexOutOfBou ndsExceptio 
n is thrown 




3 


compareOffset < 

compareValue ( ) 
compareBuffer.length = 5 
compareOffset = -1 
compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


compareLength >compareBuffer.length 

compareValue ( ) 
compareBuffer.length = 5 
compareOffset = 
compareLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


compareOffset + compareLength 
>compareBuffer. length 

compareValue () 
compareBuffer.length = 5 
compareOffset = 3 
compareLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


compareLength < 

compareValue () 
compareBuffer.length = 5 
compareOffset = 
compareLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


appendTLVO with TAG: OD and length 6 
Select Text String TLV 








valueOffset > Text String Length 

compareValue () 
valueOffset = 6 
compareBuffer.length = 15 
compareOffset = 
compareLength = 1 


Tooll<itException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

compareValue () 
valueOffset = -1 
compareBuffer.length = 15 
compareOffset = 
compareLength = 1 


Tooll<itException.OUT OF TLV 
BOUNDARIES is thrown 




9 


compareLength > Text String length 

compareValue () 
valueOffset = 
compareBuffer.length = 15 
compareOffset = 
compareLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


10 


valueOffset + compareLength > Text String 
lengtli 

compareValue () 
valueOffset = 2 
compareBuf fer . length = 15 
compareOf fset = 
compareLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Initialize the handler 








compareValue () 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown 




12 


appendTLV with TAG: OD and value: 04 00 01 

...OF 

Select Text String TLV 








Initialize compareBuffer 

compareBuffer = 
04 00 01 ... OF 








Compare buffers 

compareValue () 
valueOffset = 
compareOf fset = 
compareLength = 17 


Result is OOh 




13 


Initialize compareBuffer 

compareBuffer = 
04 00 01 02 03 

04 05 06 07 08 

05 OA OB OC OD 
OE 10 








Compare buffers with same parameters 


Result is -1 




14 


Initialize compareBuffer 

compareBuffer = 
03 00 01 ... OF 








Compare buffers with same parameters 


Result is +1 




15 


Initialize compareBuffer 

compareBuffer = 
55 55 55 02 03 
04 05 06 07 08 
09 OA OB ... 81 
55 55 55 55 55 

clear the handler 

AppendTLV with TAG OxOD and value 0x01 

0x02 ... 0x83 








Compare buffers 

compareValue () 
valueOffset = 2 
compareOf fset = 3 
compareLength = 0x81 


Result is OOh 




16 


Initialize compareBuffer 

compareBuffer = 
55 55 55 02 03 
04 05 06 07 08 
09 OA OB ... 84 
55 55 55 55 55 








Compare buffers with same parameters 


Result is -1 




17 


Initialize compareBuffer 

compareBuffer = 
55 55 55 02 03 
04 05 06 07 08 
09 OA OB ... 82 
55 55 55 55 55 








Compare buffers with same parameters 


Result is +1 




18 


Successful call, compareValueO with length =0 

compareBuf fer . length = 15 
compareOf fset = 15 
compareLength = 


Result of compareValueO is 




19 


HANDLER_NOT_AVAILABLE exception 

Call post{) method, then compareValueQ 


ToolkitException. HANDLER NOT 
AVAILABLE is thrown 
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5.2.3.1 Method findAndCopyValue(byte tag, byteQ dstBuffer, short valueOffset) 

Test Area Reference: Api_2_Erh_Facyb_Bs. 

5.2.3.10.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short f indAndCopyValue (byte tag, 

byte[] dstBuffer, 
short dstOffset) 
throws Java . lang.NullPointerException, 

Java . lang. ArraylndexOutOfBoundsException, 
Toolkit Except ion 



5.2.3.10.1.1 



Normal execution 



• CRRNl: looks for the first occurrence of a TLV element from the beginning of a TLV list and copy its value 
into a destination buffer. 

• CRRN2: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current 
TLV is no longer defined. 

• CRRN3: if the method is successful then the corresponding TLV becomes current and dstOffset + length of 
the copied value is returned. 

• CRRN4: The search method is comprehension required flag independent. 

5.2.3.10.1.2 Parameter errors 

• CRRP 1 : if dstBuffer is null NullPointerException shall be thrown. 

• CRRP2: if dstOffset would cause access outside array bounds ArraylndexOutOfBoundsException shall be 
thrown. 



5.2.3.10.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

5.2.3.10.2 Test area files 

Specific triggering: Unrecognized Envelope: 

Test Source: Test_Api_2_Erh_Facyb_Bs.java. 
Test Applet: Api_2_Erh_Facyb_Bs_Ljava. 

Cap File: api_2_erh_facyb_bs.cap. 



5.2.3.10.3 



Test coverage 



CRR number 


Test case number 


N1 


8, 10, 12 


N2 


6 


N3 


7, 9, 11 


N4 


13, 14, 15, 16 


P1 


1 


P2 


2,3,4,5 


CI 


17 
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5.2.3.10.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Initialize the handler 








findAndCopyValueO with a null dstBuffer 


NullPointerException is thrown 




2 


appendTLVQ with TAG: CD and length 16 
Select Text String TLV 








dstOffset > dstBuffer.length 

findAndCopyValue () 
tag = ODh 

dstBuffer.length = 20 
dstOffset = 20 


Array 1 ndexOutOfBou ndsExceptio 
n is thrown 




3 


dstOffset < 

findAndCopyValue () 
dstBuffer.length = 20 
dstOffset = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


dstOffset + length >dstBuffer.length 

findAndCopyValue () 
dstBuffer.length = 20 
dstOffset = 5 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


length > dstBuffer.length 

findAndCopyValue () 
dstBuffer.length = 15 

dstOffset = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


clear the handler, appendTLVQ with TAG 02 
and Length 02 








Select a TLV (tag 02h) 








findAndCopyValue () 
tag = 03h 


Tooll<itException. UNAVAILABLE 
ELEMENT is thrown 






Call the getValueLengthO method 


Tooll<itException. UNAVAILABLE 
ELEIVIENT is thrown. 




7 


appendTLVQ with TAG: OD and value: 04 00 01 
...OF 








Successful call 

findAndCopyValue () 
Tag = ODh 

dstBuffer.length = 17 
dstOffset = 


Result of findAndCopyValueQ is 
17 




8 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




9 


Initialize dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

findAndCopyValue () 
dstBuffer.length = 20 
dstOffset = 2 


Result of findAndCopyValueQ is 
19 




10 


Compare buffer 

buffer = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 


Result is OOh 




11 


clear the handler, appendTLVQ with TAG: OD 
and value: 04 00 01 ...OF 








append a 2"" Text String TLV 








Successful call 

findAndCopyValue () 
tag = ODh 

dstBuffer.length = 17 
dstOffset = 


Result of findAndCopyValueQ is 
17 




12 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 
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Id 


Description 


API Expectation 


APDU Expectation 


13 


clear the handler, appendTLV() with TAG: CD 
and value: 04 00 01 ...OF 








Successful call (with tag 8Dh) 

findAndCopyValue () 
tag = 8Dh 

dstBuffer. length = 17 
dstOffset = 


Result of findAndCopyValueQ is 
17 




14 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




15 


Append tag OFh 

clear the Handler . 

AppendTLVO with tag OxOF and value 

01 02 ... 80 








Successful call (with tag 8Fh) 

findAndCopyValue () 
tag = BFh 

dstBuffer .length = 0x83 
dstOffset = 3 


Result of findAndCopyValueQ is 
0x83 




16 


Compare buffer 

buffer = 55 55 55 00 01 ... 80 


Result is OOh 




17 


HANDLER_NOT_AVAILABLE exception 

Call postO method, then findAndCopyValue() 


ToolkitException. HANDLER NOT 
AVAILABLE is thrown 





5.2.3.1 1 Method findAndCopyValue(byte tag, byte occurrence, short valueOffset, 

byte[] dstBuffer, short dstOffset, short dstLength) 

Test Area Reference: Api_2_Erh_Facybbs_Bss. 

5.2.3.1 1.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short findAndCopyValue (byte tag, 

byte occurrence, 
short valueOffset, 
byte[] dstBuffer, 
short dstOffset, 
short dstLength) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
ToolkitException 



5.2.3.11.1.1 



Normal execution 



• CRRNl: looks for the indicated occurrence of a TLV element from the beginning of a TLV list and copy its 
value into a destination buffer. 

• CRRN2: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current 
TLV is no longer defined. 

• CRRN3: if the method is successful then the corresponding TLV becomes current and dstOffset + dstLength is 
returned. 

• CRRN4: The search method is comprehension required flag independent. 

5.2.3.11.1.2 Parameter errors 

• CRRPl: if dstBuffer is null NullPointerException shall be thrown. 

• CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative 
ArraylndexOutOfBoundsException shall be thrown. 
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• CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException.OUT_OF_TLV_BOUNDARIES. 

• CRRP4: if an input parameter is not valid (e.g. occurrence = 0) an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException.BAD_INPUT_PARAMETER. 



5.2.3.11.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

5.2.3.11.2 Test area files 

Specific triggering: Unrecognized Envelope: 

Test Source: Test_Api_2_Erh_Facybbs_Bss.java. 
Test Applet: Api_2_Erh_Facybbs_Bss_l.java. 

Cap File: api_2_erh_facybbs_bss.cap. 



5.2.3.11.3 



Test coverage 



CRR number 


Test case number 


N1 


13, 15, 17, 19 


N2 


11 


N3 


12, 14, 16, 18,24 


N4 


20,21,22, 23 


PI 


1 


P2 


2, 3, 4, 5, 6 


P3 


7,8,9, 10 


P4 


26 


CI 


25 



5.2.3.11.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Initialize the handler 








findAndCopyValueQ with a null dstBuffer 


NullPointerException is tlirown 




2 


appendTLVQ with TAG: CD and length 16 








dstOffset > dstBuffer.length 

f IndAndCopyValue () 

tag = ODh, occurrence = 1 

valueOffset = 

dstBuffer.length = 5 

dstOffset = 5 

dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


dstOffset < 

f IndAndCopyValue () 
dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


dstLength >dstBuffer.length 

f IndAndCopyValue () 
dstBuffer.length = 5 
dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + dstLength >dstBuffer.length 

f IndAndCopyValue () 
dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


Array 1 ndexOutOfBou ndsExceptio 
n is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


6 


dstLength < 

f IndAndCopyValue () 
dstBuffer . length = 5 
dstOffset = 
dstLength = -1 


Array 1 ndexOutOfBou ndsExceptio 
n is thrown 




7 


appendTLVO with TAG: OD and length 6 








valueOffset > Text String Length 

f IndAndCopyValue () 

tag = ODh, occurrence = 1 

valueOffset = 6 

dstBuffer .length = 15 

dstOffset = 

dstLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

f IndAndCopyValue () 
valueOffset = -1 
dstBuffer .length = 15 
dstOffset = 
dstLength = 1 


Tooll<itException.OUT OF TLV 
BOUNDARIES is thrown 




9 


dstLength > Text String length 

f IndAndCopyValue () 
valueOffset = 
dstBuffer .length = 15 
dstOffset = 
dstLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


valueOffset + dstLength > Text String length 

f IndAndCopyValue () 
valueOffset = 2 
dstBuffer .length = 15 
dstOffset = 
dstLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


clear the handler, appendTLVQ with TAG 02 
and Length 02 








Select a TLV (tag 02h) 








f IndAndCopyValue () 
tag = ODh 
occurrence = 2 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown 






Call the getValueLength ( ) method 


ToolkitException. UNAVAILABLE_ 
ELEMENT is thrown. 




12 


clear the handler and appendTLV() with TAG: 
OD and value: 04 00 01 ... OF 








Successful call 

f IndAndCopyValue () 

tag = ODh, occurrence = 1 

valueOffset = 

dstBuffer. length = 17 

dstOffset = 

dstLength = 17 


Result of findAndCopyValueQ is 
17 




13 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




14 


Initialize dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

f IndAndCopyValue () 

tag = ODh, occurrence = 1 

valueOffset = 2 

dstBuffer. length = 20 

dstOffset = 3 

dstLength = 12 


Result of findAndCopyValueQ is 
15 




15 


Compare buffer 

buffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 


Result is OOh 
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Id 


Description 


API Expectation 


APDU Expectation 


16 


Append a Text String TLV 

tag = OD 

buffer = 00 11 22 33 44 55 (no specific 

DCS byte) 








Successful call 

f IndAndCopyValue () 

tag = ODh, occurrence = 1 

valueOffset = 

dstBuffer .length = 20 

dstOffset = 

dstLength = 17 


Result of findAndCopyValueQ is 
17 




17 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




18 


Successful call 

f IndAndCopyValue () 

tag = ODh, occurrence = 2 

valueOffset = 

dstBuffer . length = 6 

dstOffset = 

dstLength = 6 


Result of findAndCopyValueQ is 6 




19 


Compare buffer 

buffer = 00 11 22 33 44 55 


Result is OOh 




20 


clear the handler and appendTLV() with TAG: 
OD and value: 04 00 01 ... OF 








Successful call (with tag 8Dh) 

f IndAndCopyValue () 
tag = 8Dh 
occurrence = 1 
valueOffset = 
dstBuffer. length = 17 
dstOffset = 
dstLength = 17 


Result of findAndCopyValueO is 
17 




21 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




22 


Append tag OFh 

buffer = 00 01 ... OF 

AppendTLVO with tag OxOF and value 01 02 

... 80 








Successful call (with tag 8Fh) 

f IndAndCopyValue () 
tag = 8Fh 
occurrence = 1 
valueOffset = 
dstBuffer .length = 0x83 
dstOffset = 
dstLength = 0x80 


Result of findAndCopyValueQ is 
0x80 




23 


Compare buffer 

buffer = 00 01 ... 80 55 55 55 


Result is OOh 




24 


Successful call, findAndCopyValue() with 
length =0 

dstBuffer .length = 16 
dstOffset = 16 
dstLength = 


Result of findAndCopyValueQ is 
16 




25 


Invalid parameter 

f IndAndCopyValue () 

occurrence = 


ToolkitException.BAD_INPUT_PA 
RAIVIETER is thrown 




26 


HANDLER_NOT_AVAILABLE exception 

Call post{) method, then findAndCopyValue{) 


ToolkitException. HANDLER NOT 
AVAILABLE is thrown 













5.2.3.12 Method findAndCompareValue(byte tag, byte[] compareBuffer, short 
compareOffset) 

Test Area Reference: Api_2_Erh_Facrb_Bs. 
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5.2.3.12.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

public byte f indAndCompareValue (byte tag, 

byte[] compareBuf f er, 
short compareOf f set ) 
throws Java . lang. NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
ToolkitException 

5.2.3.12.1.1 Normal execution 

Looks for the first occurrence of a TLV element from beginning of a TLV list and compare its value with a buffer: 

• CRRN 1 : if no TLV element is found, the UN AV AILABLE_ELEMENT exception is thrown and the current 
TLV is no longer defined. 

• CRRN2: if the method is successful then the corresponding TLV becomes current. 

• CRRN3: if identical returns 0. 

• CRRN4: if the first miscomparing byte in Comprehension TLV is less than that in compareBuffer returns -1. 

• CRRN5: if the first miscomparing byte in Comprehension TLV is greater than that in compareBuffer returns 1 . 

• CRRN6: The search method is comprehension required flag independent. 

5.2.3.12.1.2 Parameter errors 

• CRRPl: if compareBuffer is null NullPointerException shall be thrown. 

• CRRP2: if compareOffset would cause access outside array bounds ArraylndexOutOfBoundsException shall 
be thrown. 



5.2.3.12.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

5.2.3.12.2 Test area files 

Specific triggering: Unrecognized Envelope: 

Test Source: Test_Api_2_Erh_Facrb_Bs.java. 
Test Applet: Api_2_Erh_Facrb_Bs_l.java. 

Cap File: api_2_erh_facrb_bs.cap. 



5.2.3.12.3 



Test coverage 



CRR number 


Test case number 


N1 


6,7 


N2 


7,9 


N3 


8, 13, 12 


N4 


10, 14 


N5 


11, 15 


N6 


17, 16 


P1 


1 


P2 


2, 3, 4, 5 


C1 


18 



ETSI 



Release 6 



169 



ETSI TS 102 268 V6.0.0 (2007-03) 



5.2.3.12.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


appendTLVQ with TAG: CD and length 16 








findAndCompareVaiueQ with a null cIstBuffer and 
tag ODh 


NullPointerException is thrown 




2 










compareOffset > compareBuffer.length 

f indAndCompareValue () 
tag = ODh 

compareBuffer.length = 20 
compareOffset = 20 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


compareOffset < 

f IndAndCompareValue () 
compareBuffer.length = 20 
compareOffset = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


compareOffset + length > 
compareBuffer.length 

f IndAndCompareValue () 
compareBuffer.length = 20 
compareOffset = 5 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


length > compareBuffer.length 

f IndAndCompareValue () 
compareBuffer.length = 15 
compareOffset = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


clear the handler, appendTLVQ with TAG 02 
and Length 02 








Select a TLV (tag 02h) 








f indAndCompareValue () 
tag = 03h 


Tooll<itException. UNAVAILABLE 
ELEIVIENT is thrown 




7 


Verify current TLV 

getValueLength ( ) 


Tooll<itException. UNAVAILABLE 
ELEIVIENT is thrown. 




8 


clear the handler and appendTLVQ with TAG: 
OD and value: 04 00 01 ... OF 








Initialize compareBuffer 

compareBuf f er = 
04 00 01 ... OF 








Compare buffers 

tag = ODh 
compareOffset = 


Result is OOh 




9 


Verify current TLV 

getValueLength ( ) 


Result is 17 




10 


Initialize compareBuffer 

compareBuffer = 
04 00 01 ... 10 








Compare buffers with same parameters 


Result is -1 




11 


Initialize compareBuffer 

compareBuffer = 
03 00 01 ... OF 








Compare buffers with same parameters 


Result is +1 




12 


Initialize compareBuffer 

compareBuffer = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 








Compare buffers 

compareOffset = 2 


Result is OOh 
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Id 


Description 


API Expectation 


APDU Expectation 


13 


Successful call with 2 TLVs 

clear the Handler 

AppendTLVO with tag OxOD and value set 

to 00 01 ... 80 81 

Append a second TLV with tag OxOD and 

value set to 00 11 22 33 44 55 








Initialize compareBuffer 

compareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OB OC 
OD OE OF . . 81 








Compare buffers 

f indAndCompareValue the first TLV 
compareOf f set = 3 


Result is OOh 




14 


Initialize compareBuffer 

CompareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OB OC 
OD OE . . 7F 81 








Compare buffers 

f IndAndCompareValue the first TLV 

compareOffset = 3 


Result is -1 




15 


Initialize compareBuffer 

compareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OB OC 
OD OE . . 80 80 








Compare buffers 

compareOffset = 3 


Result is +1 




16 


clear the handler and appendTLV() with TAG: 
OD and value: 04 00 01 ... OF 








Initialize compareBuffer 

compareBuffer = 04 00 01 ... OF 








Successful call (with tag 8Dh) 

f IndAndCompareValue () 
tag = 8Dh 

CompareBuf fer . length = 17 
compareOffset = 


Result is OOh 




17 


Append tag OFh 

buffer = 00 01 ... OF 








Initialize compareBuffer 

compareBuffer = 00 01 ... OF 








Successful call (with tag BFh) 

f IndAndCompareValue () 
tag = 8Fh 

CompareBuf fer . length =16 
compareOffset = 


Result is OOh 




18 


HANDLER_NOT_AVAILABLE exception 

Call post{) method, then findAndCompareValueQ 


ToolkitException. HANDLER NOT 
AVAILABLE is thrown 
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5.2.3.13 Method findAndCompareValue(byte tag, byte occurrence, short valueOffset, 
byte[] compareBuffer, short compareOffset, short compareLength) 

Test Area Reference: Api_2_Erh_Facrbbs_Bss. 

5.2.3.13.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte f indAndCompareValue (byte tag, 

byte occurrence, 
short valueOffset, 
byte[l compareBuffer, 
short compareOffset, 
short compareLength) 
throws Java. lang.NullPointerException, 

Java . lang . ArraylndexOutOfBoundsException, 
ToolkitException 

5.2.3.13.1.1 Normal execution 

Looks for the indicated occurrence of a TLV element from the beginning of a TLV list and compare its value with a 
buffer: 

• CRRN 1 : if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current 
TLV is no longer defined. 

• CRRN2: if the method is successful then the corresponding TLV becomes current. 

• CRRN3 : if identical is returned. 

• CRRN4: if the first miscomparing byte in Comprehension TLV is less than that in compareBuffer -1 is 
returned. 

• CRRN5: if the first miscomparing byte in Comprehension TLV is greater than that in compareBuffer 1 is 
returned. 

• CRRN6: The search method is comprehension required flag independent. 

5.2.3.13.1.2 Parameter errors 

• CRRPl: if compareBuffer is null NullPointerException shall be thrown. 

• CRRP2: if compareOffset or compareLength or both would cause access outside array bounds, or if 
compareLength is negative ArraylndexOutOfBoundsException shall be thrown. 

• CRRP3: if valueOffset, compareLength or both are out of the current TLV an instance of ToolkitException 
shall be thrown. The reason code shall be ToolkitException.OUT_OF_TLV_BOUND ARIES. 

• CRRP4: if an input parameter is not valid (e.g. occurrence = 0) an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException.BAD_INPUT_PARAMETER. 

5.2.3.13.1.3 Context errors 

• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AV AIL ABLE. 
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5.2.3.13.2 Test area files 

Specific triggering: Unrecognized Envelope: 

Test Source: Test_Api_2_Erh_Facrbbs_Bss.java. 
Test Applet: Api_2_Erh_Facrbbs_Bss_l.java. 

Cap File: api_2_erh_facrbbs_bss.cap. 



5.2.3.13.3 



Test coverage 



CRR number 


Test case number 


N1 


12,13 


N2 


15,13 


N3 


14, 18,22,21,26 


N4 


16, 19, 23 


N5 


17, 19 


N6 


25,24 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7,8,9,10 


P4 


11 


C1 


27 



5.2.3.13.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Initialize the handler 








findAndCompareValueO with a null 
compareBuffer 


NullPointerException is thrown 




2 


clear the handler and appendTLV() with TAG: 
CD and value: 04 00 01 ... OF 








compareOffset > compareBuffer.length 

f IndAndCompareValue () 
tag = ODh, occurrence = 1 
valueOffset = 
compareBuffer.length = 5 
compareOffset = 5 
compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


compareOffset < 

f IndAndCompareValue () 
compareBuffer.length = 5 
compareOffset = -1 
compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


compareLength >compareBuffer.length 

f IndAndCompareValue () 
compareBuffer.length = 5 
compareOffset = 
compareLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


compareOffset + compareLength 
>compareBuffer.length 

f IndAndCompareValue () 
compareBuffer.length = 5 
compareOffset = 3 
compareLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


compareLength < 

f IndAndCompareValue () 
compareBuffer.length = 5 
compareOffset = 

compareLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


7 


clear the handler and appendTLV() with TAG 
and length of 6 








valueOffset > Text String Length 

f IndAndCompareValue () 
tag = ODh, occurrence = 1 
valueOffset = 6 
compareBuff er . length = 15 
compareOf f set = 
compareLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

f IndAndCompareValue () 
valueOffset = -1 
compareBuff er . length = 15 
compareOf f set = 
compareLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


compareLength > Text String length 

f IndAndCompareValue () 
valueOffset = 
compareBuff er . length = 15 
compareOf f set = 
compareLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


valueOffset + compareLength > Text String 
length 

f IndAndCompareValue () 
valueOffset = 2 
compareBuff er . length = 15 
compareOf f set = 
compareLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Invalid parameter 

occurrence = 


ToolkitException.BAD_INPUT_PA 
RAIVIETER is thrown 




12 


appendTLVO with TAG 02 and length 02 








Select a TLV (tag 02h) 








f IndAndCompareValue () 
tag = ODh 
occurrence = 2 


ToolkitException. UNAVAILABLE 
ELEIVIENT is thrown 




13 


Verify current TLV 

getValueLength ( ) 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown. 




14 


clear the handler and appendTLV() with TAG: 
CD and value: 04 00 01 ... OF 








Initialize compareBuffer 

compareBuffer = 
04 00 01 ... OF 








findAndCompareValueQ 

tag = ODh, occurrence = 1 
valueOffset = 
compareOf f set = 
compareLength = 17 


Result is OOh 




15 


Verify current TLV 

getValueLength ( ) 


Result is 17 




16 


Initialize compareBuffer 

compareBuffer = 
04 00 01 ... 10 








Compare buffers with same parameters 


Result is -1 




17 


Initialize compareBuffer 

compareBuffer = 
03 00 01 ... OF 








Compare buffers with same parameters 


Result is +1 
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Id 


Description 


API Expectation 


APDU Expectation 


18 


Initialize compareBuffer 

clear the handler. 

AppendTLV with tag OxOD and data = 01 02 

03 ... 80 81 

compareBuffer = 

55 55 55 01 02 

03 04 05 06 07 

08 09 OA OB OC 

OD OE ... 80 81 








Compare buffers 

f IndAndCompareValue () 
tag = OxOD 
occurrence = 1 
valueOffset = 
compareOf f set = 3 
compareLength = 0x81 


Result is OOh 




19 


Initialize compareBuffer 

compareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OB OC 
OD OE ... 7F 81 








findAndCompareValueO with same parameters 


Result is -1 




20 


Initialize compareBuffer 

compareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OB OC 
OD OE ... 80 80 








findAndCompareValueO with same 
parameters 


Result is +1 




21 


append a second Text String TLV 

tag = ODh 

buffer = 00 11 22 33 44 55 








Initialize compareBuffer 

compareBuffer = 

55 55 55 01 ... 80 81 








findAndCompareValueO 

tag = ODh, occurrence = 1 
valueOffset = 
compareOf f set = 3 
compareLength = 0x81 


Result is OOh 




22 


Initialize compareBuffer 

compareBuffer = 
00 11 22 33 44 55 








findAndCompareValueO 

tag = ODh, occurrence = 2 
valueOffset = 
compareOf f set = 
compareLength = 6 


Result is OOh 




23 


Initialize compareBuffer 

compareBuffer = 
00 11 22 33 44 66 








findAndCompareValueO 

tag = ODh, occurrence = 2 
valueOffset = 
compareOf f set = 
compareLength = 6 


Result is -1 




24 


clear the handler and appendTLV() with TAG: 
OD and value: 04 00 01 ... OF 








Initialize compareBuffer 

compareBuffer = 04 00 01 ... OF 








Successful call (with tag 8Dh) 

f IndAndCompareValue () 
tag = 8Dh, occurrence = 1 
valueOffset = 
compareBuff er . length = 17 
compareOf f set = 
compareLength = 17 


Result is OOh 





ETSI 



Release 6 



175 



ETSI TS 102 268 V6.0.0 (2007-03) 



Id 


Description 


API Expectation 


APDU Expectation 


25 


Append tag OFh 

buffer = 00 01 ... OF 








Initialize compareBuffer 

compareBuffer = 00 01 ... OF 








Successful call (with tag 8Fh) 

f IndAndCompareValue () 
tag = 8Fh, occurrence = 1 
valueOffset = 
compareBuffer . length =16 
compareOf f set = 
compareLength =16 


Result is OOh 




26 


Successful call, findAndCompareValue() with 
length =0 

CompareBuffer . length = 16 
compareOf f set =16 
compareLength = 


Result of findAndCompareValue 
is 00 




27 


HANDLER_NOT_AVAILABLE exception 

Call postO method, then 
f IndAndCompareValue {) 


ToolkitException. HANDLER NOT 
_AVAILABLE is thrown 





5.2.3.14 Method appendArray 

Test Area Reference: Api_2_Erh_Apda. 



5.2.3.14.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

public void appendArray (byte [ ] buffer, 

short offset, 
short length) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
ToolkitException 

5.2.3.14.1.1 Normal execution 

• CRRN 1 : appends a buffer into the EditHandler buffer. 

• CRRN2: a successful append does not modify the TLV selected. 

5.2.3.14.1.2 Parameter errors 

• CRRPl: if buffer is null, a Java. lang. NullPointerException is thrown. 

• CRRP2: if offset or length or both would cause access outside the array bounds, or if length is negative, a 
java.lang. ArraylndexOutOfBoundsException is thrown. 



5.2.3.14.1.3 



Context errors 



• CRRC 1 : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW. 

• CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE. 
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5.2.3.14.2 Test area files 

Specific triggering: Unrecognized Envelope: 

Test Source: Test_Api_2_Erh_Apda_Bss.java. 
Test Applet: Api_2_Erh_Apda_Bss_l.java. 

Cap File: api_2_erh_apda_bss.cap. 



5.2.3.14.3 



Test coverage 



CRR number 


Test case number 


N1 


9, 10, 11 


N2 


8 


P1 


1 


P2 


2,3,4,5,6 


C1 


7 


C2 


12 



5.2.3.14.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 




Initialize the envelope response handler with a 
TLV of length 1 






1 


Null buffer 


NullPointerException is thrown 




2 


offset > buffer.length 

appendArray () 
buffer.length = 5 
offset = 5 
length = 1 


Array 1 ndexOutOfBou ndsExceptio 
n is tiirown 




3 


offset < 

appendArray () 
buffer.length = 5 
offset = -1 
length = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


length > buffer.length 

appendArray () 
buffer.length = 5 
offset = 
length = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


offset + length > buffer.length 

appendArray () 
buffer.length = 5 
offset = 3 
length = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


length < 

appendArray ( ) 
buffer.length = 5 
offset = 
length = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Handler overflow exception 

appendArray ( ) 

buffer.length = getCapacity ( ) +1 

offset = 

length = getCapacity {) +1 


Tooll<itException.HANDLER_OVE 
RFLOW is thrown 




8 


append the handler with TLVs: 

81 03 11 22 33 

82 02 99 77 








findTLVO 0x81 








Successful call 

appendArray () 
buffer = FF FE ... F8 
offset = 
length = 8 








Verify Current TLV: Call getValueLength() 


Result is 03h 
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Id 


Description 


API Expectation 


APDU Expectation 


9 


Clear the handler 








Successful call 

appendArray () 
buffer = FF FE ... F8 
offset = 
length = 8 








Call copyO method 








Compare handler 

compareBuf fer = FF FE ... F8 


Result is OOh 




10 


Successful call 

appendArray ( ) 
buffer = 00 01 ... 07 
offset = 2 
length = 6 








Call copyO method 








Compare handler 

compareBuffer = FF FE ... F8 02 03 ... 07 


Result is OOh 




11 


Successful call 

appendArray ( ) 
buffer = 11 22 ... 88 
offset = 2 
length = 4 








Call copyO method 








Compare handler 

compareBuffer = FF FE ... F8 02 03 ... 07 33 
44 55 66 


Result is OOh 




12 


HANDLER_NOT_AVAILABLE exception 

Call postO method, then appendArray () 


ToolkitException. HANDLER NOT 
AVAILABLE is thrown 





5.2.3.1 5 Method appendTLV(byte tag, byte value) 

Test Area Reference: Api_2_Erh_Aptlbb. 

5.2.3.15.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void appendTLV (byte tag, byte value) 
throws ToolkitException 

5.2.3.15.1.1 Normal execution 

• CRRNl: Appends a TLV element to the current TLV list (1-byte element). 

• CRRN2: A successful append does not modify the TLV selected. 

5.2.3.15.1.2 Parameter errors 
No requirements 

5.2.3.15.1.3 Context errors 

• CRRC 1 : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW. 

• CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE. 
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5.2.3.15.2 Test area files 

Specific triggering: Unrecognized Envelope: 

Test Source: Test_Api_2_Erh_Aptlbb.java. 
Test Applet: Api_2_Erh_Aptlbb_l.java. 

Cap File: api_2_erh_aptlbb.cap. 



5.2.3.15.3 



Test coverage 



CRR number 


Test case number 


N1 


3,4 


N2 


2 


C1 


1 


C2 


5 



5.2.3.15.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call appendArrayO 

length = getCapacity () -1 








Handler Overflow exception: 
Call appendTLVO method 


ToolkitException. HANDLER OVE 
RFLOW is thrown. 




2 


clear the handler, append the handler with 
TLVs: 

81 03 11 22 33 

82 02 99 77 








Select Command Details TLV 








Call the appendTLVO method 








Verify Current TLV: Call getValueLength() 
method 


Result is 03h 




3 


Clear the handler 








Successful call 

appendTLVO 
tag = 84h 
value = OOh 








Call copyO method 








Compare handler 

compareBuffer = 84 01 00 


Result is OOh 




4 


Successful call 

appendTLV () 
tag = Olh 
value = Feh 








Call copyO method 








Compare handler 

compareBuffer = 84 01 00 01 01 FE 


Result is OOh 




5 


HANDLER_ NOT_AVAILABLE exception 

Call postO method, then appendTLVO 


ToolkitException. HANDLER NOT 
AVAILABLE is thrown 





5.2.3.1 6 Method appendTLV(byte tag, byte valuel , byte value2) 

Test Area Reference: Api_2_Erh_Aptlbbb. 

5.2.3.16.1 Conformance requirements 

The method with following header shall be compliant to its definition in the API. 

public void appendTLV (byte tag, byte valuel, byte value2) 
throws ToolkitException 



ETSI 



Release 6 



179 



ETSI TS 102 268 V6.0.0 (2007-03) 



5.2.3.16.1.1 Normal execution 

• CRRNl: Appends a TLV element to the current TLV list (2-byte element). 

• CRRN2: A successful append does not modify the TLV selected. 

5.2.3.16.1.2 Parameter errors 
No requirements. 

5.2.3.16.1.3 Context errors 

• CRRC 1 : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW. 

• CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE. 

5.2.3.16.2 Test area files 

Specific triggering: Unrecognized Envelope: 

Test Source: Test_Api_2_Erh_Aptl Bbb.java. 
Test Applet: Api_2_Erh_Aptl Bbb_l .Java. 

Cap File: api_2_erh_aptl bbb.cap. 



5.2.3.16.3 



Test coverage 



CRR number 


Test case number 


N1 


3,4 


N2 


2 


CI 


1 


C2 


5 



5.2.3.16.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call the appendArrayO with length of 
getCapacity()-1 








Handler Overflow exception: 
Call appendTLVO method 


ToolkitException. HANDLER OVE 
RFLOW is thrown 




2 


clear the handler, append the handler with 
TLVs: 

81 03 11 22 33 

82 02 99 77 








Select Command Details TLV 








Call appendTLVO method 








Verify Current TLV: Call getValueLengthO 
method 


Result is 03h 




3 


Clear the handler 








Successful call 

appendTLV () 
tag = 84h 
valuel = OOh 
value2 = Olh 








Call copyO method 








Compare handler 

compareBuf fer = 84 02 00 01 


Result is OOh 
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Id 


Description 


API Expectation 


APDU Expectation 


4 


Successful call 

appenciTLV () 
tag = Olh 
valuel = FEh 
value2 = FDh 








Call copyO method 








Compare handler 

compareBuffer = 84 02 00 01 01 02 FE FD 


Result is OOh 




5 


HANDLER_NOT_AVAILABLE exception 

Call postO method, then appendTLVO 


ToolkitException. HANDLER NOT 
AVAILABLE is thrown 





5.2.3.17 Method appendTLV(byte tag, byte[ ] value, short valueoffset, short 
valuelength) 

Test Area Reference: Api_2_Erh_Aptlb_Bss. 

5.2.3.17.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void appendTLV (byte tag, 

byte [ ] value, 
short valueoffset, 
short valuelength) 
throws Java . lang . NullPointerException, 

Java . lang. ArraylndexOutOfBoundsException, 
ToolkitException 

5.2.3.17.1.1 Normal execution 

• CRRNl: Appends a TLV element to the current TLV list (byte-array element). 

• CRRN2: A successful append does not modify the TLV selected. 

5.2.3.17.1.2 Parameter errors 

• CRRPl: if value is null, a java.lang. NullPointerException is thrown. 

• CRRP2: if valueoffset or valuelength or both would cause access outside the array bounds, or if length is 
negative, a Java. lang. ArraylndexOutOfBoundsException is thrown. 



5.2.3.17.1.3 



Context errors 



• CRRC 1 : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW. 

• CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE. 

• CRRC3: if valuelength is greater than 255, a ToolkitException is thrown with reason code 
BAD_INPUT_PARAMETER. 

5.2.3.17.2 Test area files 

Specific triggering: Unrecognized Envelope: 

Test Source: Test_Api_2_Erh_Aptlb_Bss.java. 
Test Applet: Api_2_Erh_Aptlb_Bss_l.java. 

Cap File: api_2_erh_aptlb_bss.cap. 
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5.2.3.17.3 



Test coverage 



CRR number 


Test case number 


N1 


10, 11, 12, 13 


N2 


9 


P1 


1 


P2 


2, 3, 4, 5, 6 


C1 


7 


C2 


14 


C3 


8 



5.2.3.17.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Null value 


NullPointerException is thrown 




2 


valueOffset > value.length 

appendTLVO 
value . length = 5 
valueOffset = 5 
valueLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


valueOffset < 

appendTLVO 
value.length = 5 
valueOffset = -1 
valueLength = 1 


Array 1 ndexOutOfBou ndsExceptio 
n is thrown 




4 


valueLength > value.length 

appendTLVO 
value.length = 5 
valueOffset = 
valueLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


ValueOffset + valueLength > value.length 

appendTLVO 
value.length = 5 
valueOffset = 3 
valueLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


valueLength < 

appendTLV () 
value.length = 5 
valueOffset = 
valueLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Handler overflow exception 

Call the appenclArrayO with length of 
getCapacity{)-1, appendTLVO 

value.length = 256 
valueOffset = 
valueLength = 254 


ToolkitException.HANDLER_OVE 
RFLOW is thrown 




8 


Bad parameter exception 

Clear the handler, appendTLVO 

value.length = 256 
valueOffset = 
valueLength = 256 


ToolkitException.BAD_INPUT_PA 
RAIVIETER is thrown 




9 


clear the handler, append the handler with 
TLVs: 

81 03 11 22 33 

82 02 99 77 








Select Command Details TLV 








Successful call 

appendTLVO 

tag = 04 

value = FF FE ... F8 

valueOffset = 

valueLength = 8 








Verify Current TLV: Call getValueLength() 


Result is 03h 
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Id 


Description 


API Expectation 


APDU Expectation 


10 


Clear the handler 








Successful call 

appendTLVO 

tag = 04 

value = FF FE ... F8 

valueOffset = 

valueLength = 8 








Call copyO method 








Compare handler 

CompareBuf fer = 04 08 FF FE ... F8 


Result is 00 




11 


Successful call 

appendTLVO 

tag = 85h 

value = 00 01 ... 07 

valueOffset = 2 

valueLength = 6 








Call copyO method 








Compare handler 

compareBuffer = 04 08 FF FE ... F8 85 06 02 
03 ... 07 


Result is 00 




12 


Successful call 

appendTLVO 

tag = 01 

value = 11 22 ... 88 

valueOffset = 2 

valueLength = 4 








Call copyO method 








Compare handler 

compareBuffer = 04 08 FF FE ... F8 85 06 02 
03 ... 07 01 04 33 44 55 66 


Result is 00 




13 


Clear the handler 








Successful call 

appendTLV () 

tag = 04 

value = 00 01 ... 7F 

valueOffset = 

valueLength = 80h 








Call copvO method 








Compare handler 

compareBuffer = 04 81 80 00 01. ..7F 


Result is 00 




14 


HANDLER_NOT_AVAILABLE exception 

Call postO method, then appendTLVO 


ToolkitExceptlon. HANDLER NOT 
AVAILABLE is thrown 





5.2.3.1 8 Method appendTLV(byte tag, byte valuel , byte[ ] value2, short value2offset, 
short value2length) 

Test Area Reference: Api_2_Erh_Aptlbb_Bss. 

5.2.3.18.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void appendTLV (byte tag, 

byte valuel 
byte [ ] value2, 
short value2of f set , 
short value21ength) 
throws Java . lang . NullPointerException, 

Java .lang . Array IndexOutOfBoundsExcept ion, 
ToolkitExceptlon 

5.2.3.18.1.1 Normal execution 

• CRRNl: Appends a TLV element to the current TLV list (1 byte and a byte-array element). 

• CRRN2: A successful append does not modify the TLV selected. 
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5.2.3.18.1.2 Parameter errors 

• CRRPl: if value2 is null, a java.lang.NullPointerException is thrown. 

• CRRP2: if value2offset or value21ength or both would cause access outside the array bounds, or if length is 
negative, a java.lang.ArraylndexOutOfBoundsException is thrown. 



5.2.3.18.1.3 



Context errors 



• CRRC 1 : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW. 

• CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE. 

• CRRC3: if valuelength is greater than 254, a ToolkitException is thrown with reason code 
BAD_INPUT_PARAMETER. 

5.2.3.18.2 Test area files 

Specific triggering: Unrecognized Envelope: 

Test Source: Test_Api_2_Erh_Aptlbb_Bss.java. 
Test Applet: Api_2_Erh_Aptlbb_Bss_l.java. 

Cap File: api_2_erh_aptlbb_bss.cap. 



5.2.3.18.3 



Test coverage 



CRR number 


Test case number 


N1 


10, 11, 12, 13 


N2 


9 


PI 


1 


P2 


2, 3, 4, 5, 6 


CI 


7 


C2 


14 


C3 


8 



5.2.3.18.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Null value2 


NullPointerException is thrown 




2 


value20ffset > value2.length 

appendTLVO 
value2 . length = 5 
value20ffset = 5 
value2Length = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


value20ffset < 

appendTLV () 
value2 . length = 5 
value20ffset = -1 
value2Length = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


value2Length > value2.length 

appendTLV () 
value2 . length = 5 
value20ffset = 
value2Length = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


value20ffset + value2Length > value2.length 

appendTLVO 
value2 . length = 5 
value20ffset = 3 
value2Length = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


6 


value2Length < 

appendTLV () 
value2 . length = 5 
value20ffset = 
value2Length = -1 


Array 1 ndexOutOfBou ndsExceptio 
n is thrown 




7 


Handler overflow exception 

Call the appenclArrayO with length of 

getCapacity{)-1 

appendTLVO 

value2 . length = 256 
value20ffset = 
value2Length = 254 


ToolkitException. HANDLER OVE 
RFLOW is thrown 




8 


Bad parameter exception 

Clear the handlerappendTLV ( ) 
value2 . length = 256 
value20ffset = 
value2Length = 256 


ToolkitException. BAD_INPUT_PA 
RAIVIETER is thrown 




9 


clear the handler, append the handler with 
TLVs: 

81 03 11 22 33 

82 02 99 77 








Select Command Details TLV 








Successful call 

appendTLVO 

tag = 04 

valuel = 05 

value2 = FF FE ... F8 

value20ffset = 

value2Length = 8 








Verify Current TLV: Call getValueLength() 


Result is 03h 




10 


Clear the handler 








Successful call 

appendTLV () 

tag = 04 

valuel = 05 

value2 = FF FE ... F8 

value20ffset = 

value2Length = 8 








Call copyO method 








Compare handler 

CompareBuffer = 04 09 05 FF FE ... F8 


Result is 00 




11 


Successful call 

appendTLVO 
tag = 85h 
valuel = 55h 
value2 = 00 01 ... 07 
value20ffset = 2 
value2Length = 6 








Call copvO method 








Compare handler 

CompareBuffer = 

04 09 05 FF FE ... F8 

85 07 55 02 03 ... 07 


Result is 00 




12 


Successful call 

appendTLVO 
tag = 01 
valuel = 44h 
value2 = 11 22 ... 88 
value20ffset = 2 
value2Length = 4 








Call copyO method 








Compare handler 

CompareBuffer = 
04 09 05 FF FE ... F8 
85 07 55 02 03 ... 07 
01 05 44 33 44 55 66 


Result is 00 
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Id 


Description 


API Expectation 


APDU Expectation 


13 


Clear the handler 








Successful call 

appendTLVO 
tag = 04 
valuel = 00 
value2 = 01 ... 7F 
value20ffset = 
value2Length = 7Fh 








Call copyO method 








Compare handler 

compareBuf fer = 04 81 80 00 01. ..7F 


Result is 00 




14 


HANDLER_NOT_AVAILABLE exception 

Call postO method, then appendTLVO 


ToolkitException. HANDLER NOT 
AVAILABLE is thrown 





5.2.3.19 Method clear 

Test Area Reference: Api_2_Erh_Cler. 
5.2.3.19.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

Public void clear () 

throws ToolkitException 

5.2.3.19.1.1 Normal execution 

• CRRNl: Clears the TLV list of an EditHandler and resets the current TLV selected. 



5.2.3.19.1.2 
No requirements. 

5.2.3.19.1.3 



Parameter errors 



Context errors 



• CRRC 1 : if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE. 

5.2.3.19.2 Test area files 

Specific triggering: Unrecognized Envelope: 
Test Source: Test_Api_2_Erh_Cler.java. 
Test Applet: Api_2_Erh_Cler_l.java. 

Cap File: api_2_erh_cler.cap. 



5.2.3.19.3 



Test coverage 



CRR number 


Test case number 


N1 


1,2 


CI 


3 
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5.2.3.19.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


append the handler with TLVs: 

81 03 11 22 33 

82 02 99 77 

Select Command Details TLV 
Call the getLengthO method 


Result of getLengthO is not null 






Clear the handler 

Call the getLengthO method 


Result of getLengthO is 




2 


Call the getValueLengthO method 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown 




3 


HANDLER_NOT_AVAILABLE exception 

Call appendTLVO method, then postO and 
then clear 


ToolkitException. HANDLER NOT 
AVAILABLE is thrown 





5.2.3.20 Method getCapacity 

Test Area Reference: Api_2_Erh_Gcap. 

5.2.3.20.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte getCapacity ( ) 

5.2.3.20.1.1 Normal execution 

• CRRNl: The method shall return the maximum size of the Comprehension TLV list managed by the handler. 

5.2.3.20.1 .2 Parameter errors 
No requirements 

5.2.3.20.1.3 Context errors 

• CRRC 1 : The method shall throw HANDLER_NOT_AVAILABLE ToolkitException if the handler is busy. 

5.2.3.20.2 Test area files 

Test Source: Test_Api_2_Erh_Gcap.java. 
Test Applet: Api_2_Erh_Gcap_l.java. 

Cap File: api_2_erh_gcap.cap. 

5.2.3.20.3 Test coverage 



CRR number 


Test case number 


N1 


1 


C1 


Tested in CAT Runtime 
Environment part: 
FWK MHA ERHD 
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5.2.3.20.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


EnvelopeResponseHandler available 

1- Send envelope Menu Selection 

2- The applet calls getTheHandler () method 

3- The applet calls getCapacity () method 
on the EnvelopeResponseHandler 

4- The applet fills the handler with the 
maximum capacity using AppendTLVO method 

5- The applet calls clear () method on the 
EnvelopeResponseHandler 

6- The applet fills the handler with the 
maximum capacity plus one, using 
AppendTLVO method 


1- Applet is triggered 

2- No exception is thrown 

3- No exception is tlirown 

4- No exception is thrown 

5- No exception is thrown 

6- HANDLER_OVERFLOW 
exception is thrown 





5.2.3.21 Method getValueShort 

Test Area Reference: Api_2_Erh_Gvsh. 

5.2.3.21.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getValueShort (short valueOffset) 
throws ToolkitException 



5.2.3.21.1.1 



Normal execution 



• CRRNl: Gets a short from the last TLV element which has been found in the handler and returns its value 
(1 short). 



5.2.3.21.1.2 



Parameter errors 



• CRRP 1 : if valueOffset is out of the current TLV an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException.OUT_OF_TLV_BOUND ARIES. 



5.2.3.21.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

• CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException.UNAVAILABLE_ELEMENT. 

5.2.3.21.2 Test area files 

Specific triggering: Unrecognized Envelope: 
Test Source: Test_Api_2_Erh_Gvsh.java. 
Test Applet: Api_2_Erh_Gvsh_l.java. 

Cap File: api_2_erh_gvsh.cap. 



5.2.3.21.3 



Test coverage 



CRR number 


Test case number 


N1 


3, 4, 5, 6, 7, 8 


PI 


2 


CI 


9 


C2 


1 
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5.2.3.21.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


appendTLVO 82 02 81 82, appendTLV() 81 03 
11 22 FE 

findTLVO with TAG 03 








getValueShort (0) 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown 




2 


Search TLV Olh 








getValueShort (3) 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




3 


Search TLV Olh 








getValueShort (1) 


Result is 22h FEh 




4 


Search TLV 02h 








getValueShort (0) 


Result is 81 h82h 




5 


appendTLVO with TAG OD, Length 0x7E, 
Value: 00, 01, ..., 7D 








getValueShort (7C) 


Result is 7Ch 7Dh 




6 


clear the handler, appendTLVO with TAG 
OD, Length 0x80, Value: 00, 01, ..., 7F 








getValueShort (7D) 


Result is 7Dh 7Eh 




7 


getValueShort (7E) 


Result is 7Eh 7Fh 




8 


clear the handler, appendTLVO with TAG 
OD, Length OxFl, Value: 00, 01, ..., FO 








getValueShort (EF) 


Result is EFh FOh 




9 


HANDLER_NOT_AVAILABLE exception 

Call postO method, then getValueShort () 


ToolkitException. HANDLER NOT 
AVAILABLE is thrown 





5.2.3.22 Method appendTLV(byte tag, byte valuel , short value2) 

Test Area Reference: Api_2_Erh_Aptlbbs. 

5.2.3.22.1 Conformance requirements 

The method with following header shall be compliant to its definition in the API. 

public void appendTLV (byte tag, 

byte valuel, 
short value2) 
throws ToolkitException 

5.2.3.22.1.1 Normal execution 

• CRRNl: Appends a TLV element to the current TLV list (3-byte element(l-byte,l-short)). 

• CRRN2: A successful append does not modify the TLV selected. 

5.2.3.22.1.2 Parameter errors 
No requirements. 

5.2.3.22.1 .3 Context errors 

• CRRC 1 : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW. 

• CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER NOT AVAILABLE. 
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5.2.3.22.2 Test area files 

Specific triggering: Unrecognized Envelope: 

Test Source: Test_Api_2_Erh_Aptlbbs.java. 
Test Applet: Api_2_Erh_Aptlbbs_l.java. 

Cap File: api_2_erh_aptlbbs.cap. 



5.2.3.22.3 



Test coverage 



CRR number 


Test case number 


N1 


3,4 


N2 


2 


C1 


1 


C2 


5 



5.2.3.22.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call the appendArrayO with length of 
getCapacity()-1 








Handler Overflow Exception: 
Call appendTLVO method 


ToolkitException. HANDLER 
VERFLOW is thrown 




2 


clear the handler, append the handler with TLVs: 

81 03 11 22 33 

82 03 99 77 00 








Select Command Details TLV 








Call appendTLVO method 








Verify Current TLV: Call getValueLength() 
method 


Result is 03li 




3 


Clear the handler 








Successful call 

appendTLVO 
tag = 84h 
valuel = OOh 
value2 = Olh 02h 








Call copyO method 








Compare handler 
compareBuffer = 84 03 00 01 02 


Result is OOh 




4 


Successful call 

appendTLVO 
tag = Olh 
valuel = FEh 
value2 = FDh FCh 








Call copyO method 








Compare handler 
compareBuffer = 84 03 00 01 02 01 03 FE FD FC 


Result is OOh 




5 


HANDLER_NOT_AVAILABLE exception 

Call postO method, then AppendTLVO 


ToolkitException. HANDLER N 
OT AVAILABLE is thrown 





5.2.3.23 Method appendTLV(byte tag, short value) 

Test Area Reference: Api_2_Erh_Aptlbs. 

5.2.3.23.1 Conformance requirements 

The method with following header shall be compliant to its definition in the API. 

public void appendXLV (byte tag, 

short value) 
throws ToolkitException 
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5.2.3.23.1.1 Normal execution 

• CRRNl: Appends a TLV element to the current TLV list (2-byte or 1 -short element). 

• CRRN2: A successful append does not modify the TLV selected. 

5.2.3.23.1 .2 Parameter errors 
No requirements. 

5.2.3.23.1.3 Context errors 

• CRRC 1 : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW. 

• CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE. 

5.2.3.23.2 Test area files 

Specific triggering: Unrecognized Envelope: 

Test Source: Test_Api_2_Erh_Aptlbs.java. 
Test Applet: Api_2_Erh_Aptlbs_l.java. 

Cap File: api_2_erh_aptlbs.cap. 



5.2.3.23.3 



Test coverage 



CRR number 


Test case number 


N1 


3,4 


N2 


2 


CI 


1 


C2 


5 



5.2.3.23.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call appendArrayO 

length = getCapacity ( ) -1 








Handler Overflow Exception: 
Call appendTLVQ method 


ToolkitException. HANDLER OVE 
RFLOW is thrown 




2 


append the handler with TLVs: 

81 03 11 22 33 

82 02 99 77 








Select Command Details TLV 








Call the appendTLVO method 








Verify Current TLV: Call getValueLength() 
method 


Result is 03h 




3 


Clear the handler 








Successful call 

appendTLV () 
tag = 84h 
value = OOh Olh 








Call copyO method 








Compare handler 

compareBuf fer = 84 02 00 01 


Result is OOh 
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Id 


Description 


API Expectation 


APDU Expectation 


4 


Successful call 

appendTLV () 
tag = Olh 
value = FEh FFh 








Call copyO method 








Compare handler 

compareBuffer = 84 02 00 01 01 02 FE FF 


Result is OOh 




5 


HANDLER_NOT_AVAILABLE exception 

Call postO method, then AppendTLV ( ) 


ToolkitException. HANDLER NOT 
AVAILABLE is thrown 





5.2.3.24 Method appendTLV(byte tag, short valuel , short value2) 

Test Area Reference: Api_2_Erh_Aptlbss. 

5.2.3.24.1 Conformance requirements 

The method with following header shall be compliant to its definition in the API. 

public void appendTLV (byte tag, 

short valuel, 
short value2) 
throws ToolkitException 

5.2.3.24.1.1 Normal execution 

• CRRNl: Appends a TLV element to the current TLV list (4-byte element(2-short)). 

• CRRN2: A successful append does not modify the TLV selected. 

5.2.3.24.1 .2 Parameter errors 
No requirements. 

5.2.3.24.1 .3 Context errors 

• CRRC 1 : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW. 

• CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE. 

5.2.3.24.2 Test area files 

Specific triggering: Unrecognized Envelope: 

Test Source: Test_Api_2_Erh_Aptlbss.java. 
Test Applet: Api_2_Erh_Aptlbss_l.java. 

Cap File: api_2_erh_aptlbss.cap. 



5.2.3.24.3 



Test coverage 



CRR number 


Test case number 


N1 


3,4 


N2 


2 


C1 


1 


C2 


5 
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5.2.3.24.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call the appendArrayO method with length 
equal getCapacity()-1 








Handler Overflow Exception: 
Call appendTLVO method 


ToolkitException. HANDLER OVE 
RFLOW is thrown 




2 


clear the handler, append the handler with 
TLVs: 

81 03 11 22 33 

82 02 99 77 








Select Command Details TLV 








Call appendTLVO method 








Verify Current TLV: Call getValueLength() 
method 


Result is 03h 




3 


Clear the handler 








Successful call 

appendTLVO 
tag = 84h 
valuel = OOh Olh 
value2 = 02h 03h 








Call copyO method 








Compare handler 
compareBuffer = 84 04 00 01 02 03 


Result is OOh 




4 


Successful call 

appendTLV () 
tag = Olh 
valuel = FEh FDh 
value2 = FCh FBh 








Call copyO method 








Compare handler 

compareBuffer = 84 04 00 01 02 03 01 04 FE FD 

FCFB 


Result is OOh 




5 


HANDLER_NOT_AVAILABLE exception 

Call postO method, then appendTLVO 


ToolkitException. HANDLER NOT 
AVAILABLE is thrown 





5.2.3.25 Method appendTLV(byte tag, byte[] valuel , short valuel Offset, short 
valuel Length, byte[] value2, short value20ffset, short value2Length) 

Test Area Reference: Api_2_Erh_Aptlb_Bss_Bss. 



5.2.3.25.1 



Conformance requirements 



The method with following header shall be compliant to its definition in the API. 

public void appendTLV (byte tag, 

byte [ ] valuel, 
short valuelOf f set, 
short valuelLength, 
byte [ ] value2, 
short value20f f set , 
short value2Length) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
ToolkitException 

5.2.3.25.1.1 Normal execution 

• CRRNl: Appends a TLV element to the current TLV list (2 byte arrays format). 

• CRRN2: A successful append does not modify the TLV selected. 
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5.2.3.25.1.2 Parameter errors 

• CRRPl: If valuel or value2 is null, a NullPointerException is thrown. 

• CRRP2: If valuelOffset or valuelLength or both would cause access outside valuel array bounds, or if 
valuelLength is negative, an ArraylndexOutOfBoundsException is thrown. 

• CRRP3: If value20ffset or value 2Length or both would cause access outside value2 array bounds, or if 
value2Length is negative, an ArraylndexOutOfBoundsException is thrown. 



5.2.3.25.1.3 



Context errors 



• CRRC 1 : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW. 

• CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE. 

• CRRC3: If valuelLength or value2Length is greater than 255, a ToolkitException is thrown with reason code 
BAD_INPUT_PARAMETER. 

5.2.3.25.2 Test area files 

Specific triggering: Unrecognized Envelope: 

Test Source: Test_Api_2_Erh_Aptlb_Bss_Bss.java. 
Test Applet: Api_2_Erh_Aptlb_Bss_Bss_l.java. 

Cap File: api_2_erh_aptlb_bss_bss.cap. 



5.2.3.25.3 



Test coverage 



CRR number 


Test case number 


N1 


18, 19,20,21 


N2 


17 


P1 


1,2 


P2 


3, 4, 5, 6, 7 


P3 


8, 9, 10, 11, 12 


CI 


13 


C2 


22 


C3 


14, 15 



5.2.3.25.4 



Test procedure 



id 


Description 


API Expectation 


APDU Expectation 


1 


Null valuel 


NullPointerException is thrown 




2 


Null value2 


NullPointerException is thrown 




3 


Valuel Offset > valuel .length 

appendTLVO 
valuel . length = 5 
valuelOffset = 5 
valuelLength = 1 
value2 . length = 5 
value20ffset = 
value2Length = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


ValuelOffset <0 

appendTLV () 
valuel . length = 5 
valuelOffset = -1 
valuelLength = 1 
value2 . length = 5 
value20ffset = 
value2Length = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


5 


ValuelLength > valuel .length 

appendTLV () 
valuel . length = 5 
valuelOffset = 
ValuelLength = 6 
value2 . length = 5 
value20ffset = 
value2Length = 1 


Array 1 ndexOutOfBou ndsExceptio 
n is thrown 




6 


ValuelOffset + valuel Length > valuel .length 

appendTLV () 
Valuel . length = 5 
valuelOffset = 3 
ValuelLength = 3 
value2 . length = 5 
value20ffset = 
value2Length = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Valuel Length <0 

appendTLVO 
valuel . length = 5 
valuelOffset = 
ValuelLength = -1 
value2 . length = 5 
value20ffset = 
value2Length = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




8 


Value20ffset > value2.length 

appendTLVO 
valuel . length = 5 
valuelOffset = 
ValuelLength = 1 
value2 . length = 5 
value20ffset = 5 
value2Length = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




9 


Value20ffset < 

appendTLVO 
valuel . length = 5 
valuelOffset = 
ValuelLength = 1 
value2 . length = 5 
value20ffset = -1 
value2Length = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




10 


Value2Length > value2.length 

appendTLV {) 
valuel . length = 5 
valuelOffset = 
ValuelLength = 1 
value2 . length = 5 
value20ffset = 
value2Length = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




11 


Value20ffset + value2Length > value2.length 

appendTLV () 
valuel . length = 5 
valuelOffset = 
ValuelLength = 1 
Value2. length = 5 
Value20ffset = 3 
Value2Length = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




12 


Value2Length < 

appendTLV () 
valuel . length = 5 
valuelOffset = 
ValuelLength = 1 
value2 . length = 5 
value20ffset = 
value2Length = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




13 


Handler overflow Exception 

Call the appendArray with length of 

get Capacity () -1 

appendTLVO 

Valuel .length = 256 

ValuelOffset = 

ValuelLength = 1 

Value2 .length = 256 

Value20ffset = 

Value2Length = 1 


Tooll<itExceptlon.HANDLER_OVE 
RFLOW is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


14 


Bad parameter Exception 

Clear the handler 
appendTLV () 
Valuel .length = 256 
ValuelOffset = 
ValuelLength = 256 
Value2. length = 256 
Value20ffset = 
Value2Length = 1 


ToolkitException.BAD_INPUT_PA 
RAMETER is thrown 




15 


Bad parameter Exception 

appendTLVO 
Valuel. length = 256 
ValuelOffset = 
ValuelLength = 1 
Value2 .length = 256 
Value20ffset = 
Value2Length = 256 


ToolkitException.BAD_INPUT_PA 
RAMETER is thrown 






clear the handler, append the handler with 
TLVs: 

81 03 11 22 33 

82 02 99 77 








Select Command Details TLV 






16 


Successful call 

appendTLV () 
tag = 04 

valuel = FF FE ... F8 
ValuelOffset = 
ValuelLength = 8 
value2 = F7 F6 ... FO 
value20ffset = 
value2Length = 8 








Verify Current TLV: Call getValueLength() 


Result is 03h 






Clear the handler 






17 


Successful call 

appendTLV () 
tag = 04 

valuel = FF FE ... F8 
ValuelOffset = 
ValuelLength = 8 
value2 = F7 F6 ... FO 
value20ffset = 
value2Length = 8 








Call copyO method 








Compare handler 

CompareBuffer = 04 10 FF FE ... FO 


Result is 00 




18 


Successful call 

appendTLVO 
tag = 85h 

valuel = 00 01 ... 07 
ValuelOffset = 2 
ValuelLength = 6 
value2 = 08 09 ... OF 
value20ffset = 2 
value2Length = 6 








Call copyO method 








Compare handler 

CompareBuffer = 04 10 FF FE ... FO 85 OC 02 
03 04 05 06 07 OA OB OC OD OE OF 


Result is 00 




19 


Successful call 

appendTLV () 
tag = 01 

valuel = 11 22 ... 88 
ValuelOffset = 2 
ValuelLength = 4 
value2 = 99 AA ... FF 00 
value20ffset = 2 
value2Length = 4 








Call copyO method 








Compare handler 

CompareBuffer = 04 10 FF FE ... FO 85 OC 02 
03 04 05 06 07 OA OB OC OD OE OF 01 08 33 
44 55 66 BB CC DD EE 


Result is 00 
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Id 


Description 


API Expectation 


APDU Expectation 




Clear the handler 






20 


Successful call 

appendTLVO 
tag = 04 

valuel = 00 01 ... 7F 
valuelOffset = 
valuelLength = 80h 
value2 = 80 81 ... FC 
value20ffset = 
value2Length = 7Dh 








Call copyO method 








Compare handler 

compareBuffer = 04 81 FD 00 01. ..FC 


Result is 00 




21 


HANDLER_NOT_AVAILABLE exception 

Call postO method, then appendTLVO 


ToolkitException. HANDLER NOT 
AVAILABLE is thrown 





5.2.4 Interface ProactiveHandler 
5.2.4.1 Method init 

Test Area Reference: Api_2_Pah_Init. 

5.2.4.1.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void init (byte type, 

byte qualifier, 
byte dstDevice) 



5.2.4.1.1.1 



Normal execution 



5.2.4.1.1.2 
No requirements 

5.2.4.1.1.3 
No requirements 

5.2.4.1.2 

Test Source: 
Test Applet: 
Cap File: 



CRRNl: The init() method initializes the next Proactive command in the ProactiveHandler, with Command 
details and Device Identities TLV. The source device is always the UICC Card (81h). The Comprehension 
Required flags are set. 

CRRN2: The Command number may take any value between Olh and FEh. 

CRRN3: The init() method clears the ProactiveHandler before initializing it. 

CRRN4: No TLV is selected after a call to the method. 

CRRN5: The handler is not sent to the mobile by the init() method. 

Parameter errors 



Context errors 
Test area files 

Test_Api_2_Pah_Init.j ava. 
Api_2_Pah_Init_l.java. 
api_2_p ah_init . c ap . 
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5.2.4.1.3 



Test coverage 



CRR number 


Test case number 


N1 


1,3 


N2 


2 


N3 


3 


N4 


4 


N5 


1,3 



5.2.4.1.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call the initO method 

type = Olh 
qualifier = 02h 
dstDevice = 03h 

Copy ProactiveHandler in a byte array (source) 
Compare the byte array 

reference = 

81h 03h xxh Olh 02h 

82h 02h 81h 03h 


source and reference are identical 




2 


Verify the command number value 


Olh-FEh 




3 


Call the initO method 

type = FFh 
qualifier = FEh 
destination = FDh 

Copy ProactiveHandler in a byte array (source) 
Compare the byte array 

reference = 

Blh 03h xxh FFh FEh 

82h 02h 81h FDh 


source and reference are identical 




4 


Select the 1st TLV In the handler 
Call the init() method with any value 








Call the getValueLengthQ method 


UNAVAILABLE_ELEMENT 
ToolkitException is thrown by 
getValueLengthQ 





5.2.4.2 Method initDisplaylext 

Test Area Reference: Api_2_Pah_Indt. 



5.2.4.2.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

public void initDisplaylext (byte qualifier, 

byte dcs, 
byte [ ] buffer, 
short offset, 
short length) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
ToolkitException 



5.2.4.2.1.1 



Normal execution 



CRRNl: The method shall build a DISPLAY TEXT proactive command in the ProactiveHandler, using 
qualifier, dcs and buffer parameters. Comprehension required flags are set. 

CRRN2: A call to this method clears the handler then initializes it. 
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• CRRN3: No TLV is selected after a call to the method. 

• CRRN4: The DISPLAY TEXT command is not sent by the method. 

• CRRN5: The Command Number may take any value between Olh and FEh. 

• CRRN6: If length is equal to zero, then the Text String TLV inserted in the command is a null text string TLV 
as defined in TS 101 267 [15]. 

5.2.4.2.1 .2 Parameter errors 

• CRRPl: The method shall throw NuUPointerException if buffer is null. 

• CRRP2: If offset or length or both would cause access outside array bounds, an 
ArraylndexOutOfBoundsException shall be thrown. 



5.2.4.2.1.3 



Context errors 



CRRCl: A ToolkitException.HANDLER_OVERFLOW shall be thrown if the ProactiveHandler is too small 
to put the requested data. 



5.2.4.2.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.4.2.3 



Test area files 

Test_Api_2_Pah_Indt.j ava. 
Api_2_Pah_Indt_l .Java. 
api_2_pah_indt.cap. 

Test coverage 



CRR number 


Test case number 


N1 


8,9, 10, 11, 12, 13, 14, 15, 16, 18, 19,20 


N2 


15 


N3 


17 


N4 


22 


N5 


7 


N6 


16 


PI 


1 


P2 


2, 3, 4, 5, 6 


CI 


21 



5.2.4.2.4 



Test procedure 



id 


Description 


API Expectation 


APDU Expectation 


1 


NULL as parameter to buffer 

InitDisplayText () 
buffer = NULL 


NuUPointerException is thrown 




2 


Offset > buffer.length 

InitDisplayText () 
buffer = "Text" 
offset = 5 
length = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


Offset < 

InitDisplayText {) 
buffer = "Text" 
offset = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


length > buffer.length 

InitDisplayText () 
buffer = "Text" 
offset = 
length = 5 


ArraylndexOutOfBoundsExceptio 
n is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


5 


offset + length > buffer.length 


Array 1 ndexOutOfBou ndsExceptio 






InitDisplayText () 


n is thrown 






buffer = "Text" 








offset = 3 








length = 2 






6 


length < 


ArraylndexOutOfBoundsExceptio 






InitDisplayText {) 


n is thrown 






buffer = "Text" 








offset = 3 








length = -1 






7 


Successful call, buffer is the whole buffer 

InitDisplayText () 
qualifier = 
dcs = 4 

buffer = "TextA" 
offset = 
length = 5 


No exception is thrown 






Verify the command number value 


Command number between 01 h 
and FEh 




8 


Send the command 




DISPLAY TEXT Proactive 
command 

qualifier = OOh 

dcs = 4 

Text = "TextA" 


9 


Successful call, buffer is part of a buffer with 




DISPLAY TEXT Proactive 




the end part 




command 




Send the command 








InitDisplayText {) 




qualifier = OOh 




qualifier = 




dcs = 4 




dcs = 4 




Text = "TextB" 




buffer = "12TextB" 








offset = 2 








length = 5 






10 


Successful call, buffer is part of a buffer with 




DISPLAY TEXT Proactive 




the first part 




command 




Send the command 








InitDisplayText () 




qualifier = OOh 




qualifier = 




dcs = 4 




dcs = 4 




Text = "TextC" 




buffer = "TextC12" 








offset = 








length = 5 






11 


Successful call, buffer is part of a buffer 




DISPLAY TEXT Proactive 




Send the command 




command 




InitDisplayText () 








qualifier = 




qualifier = OOh 




dcs = 4 




dcs = 4 




buffer = "12TextD34" 




Text = "TextD" 




offset = 2 








length = 5 






12 


Successful call, qualifier = 81h 




DISPLAY TEXT Proactive 




Send the command 




command 




InitDisplayText {) 








qualifier = 81h 




qualifier = 81h 




dcs = 4 




dcs = 4 




buffer = "TextE" 




Text = "TextE" 




offset = 








length = 5 
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Id 


Description 


API Expectation 


APDU Expectation 


13 


Successful call, DCS=0 (7 bits) 




DISPLAY TEXT Proactive 




Send the command 




command 




InitDisplayText () 








qualifier = 




qualifier = OOh 




dcs = 




dcs = 




buffer = "TextF" 




Text = "TextF" 




offset = 








length = 5 






14 


Successful call, DCS=8 (UCS2) 




DISPLAY TEXT Proactive 




Send the command 




command 




InitDisplayText () 








qualifier = 




qualifier = OOh 




dcs = 8 




dcs = 8 




buffer = "TextG" 




Text = "TextG" 




offset = 








length = 5 






15 


Call the InitDisplayTextO method with any 




DISPLAY TEXT Proactive 




value 




command 




Then build and send a DISPLAY TEXT 








command 




qualifier = OOh 




qualifier = 




dcs = 4 




dcs = 4 




Text = "TextHTextH" 




buffer = "TextHTextH" 








offset = 








length = 10 






16 


Successful call, text length is zero 




DISPLAY TEXT Proactive 




Send the command 




command 




InitDisplayText () 








qualifier = 




qualifier = OOh 




dcs = 4 




Text String TLV = 8D 00 




buffer = "TextHTextH" 








offset = 








length = 






17 


Select a TLV in the ProactiveHandler 


UNAVAILABLE_ELEMENT 






Call the InitDisplayTextO method 


ToolkitException is thrown by 






Call the getValueLengthO method 


getValueLengthO 




18 


Successful call, buffer length = 7Eh 




DISPLAY TEXT Proactive 




InitDisplayText () 




command 




qualifier = 








dcs = 4 




Text String TLV = 




buffer = "UUU..." 




8D 7F 04 55 55... 




offset = 








length = 7Eh 






19 


Successful call, buffer length = 7Fh 




DISPLAY TEXT Proactive 




InitDisplayText () 




command 




qualifier = 








dcs = 4 




Text String TLV = 8D 81 




buffer = "UUU..." 




80 04 55 55... 




offset = 








length = 7Fh 






20 


Successful call, buffer length = 240 




DISPLAY TEXT Proactive 




InitDisplayText () 




command 




Qualifier = 








dcs = 4 




Text String TLV = 




buffer = "UUU..." 




8D 81 Fl 04 55 55... 




offset = 








length = 240 






21 


Call the InitDisplayTextO method with a too 


HANDLER_OVERFLOW 






long buffer 


ToolkitException is thrown 






qualifier = 








dcs = 4 








buffer = "XXXX..." 








offset = 








length = 241 






22 


Call the InitDisplayTextO without sending the 




No proactive command shall 




command 




be sent expected status is 
'9000' 
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5.2.4.3 Method initGetlnkey 

Test Area Reference: Api_2_Pah_Ingk. 

5.2.4.3.1 Conformance requirement 

The method with following header shall be compliant to its definition in the APT 

public void initGetlnkey (byte qualifier, 

byte dcs, 
byte [ ] buffer, 
short offset, 
short length) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
Toolkit Except ion 

5.2.4.3.1.1 Normal execution 

CRRNl: The method shall build a GET INKEY proactive command in the ProactiveHandler, using qualifier, 
dcs and buffer parameters. Comprehension Required flags are set. 

CRRN2: A call to this method clears the handler then initializes it. 

CRRN3: No TLV is selected after a call to the method. 

CRRN4: The GET INKEY command is not sent by the method. 

CRRN5: The Command Number may take any value between Olh and FEh. 

CRRN6: If length is equal to zero, then the Text String TLV inserted in the command is a null text string TLV 
as defined in TS 101 267 [15]. 

5.2.4.3.1 .2 Parameter errors 

• CRRPl: The method shall throw NullPointerException if buffer is null. 

• CRRPl : If offset or length or both would cause access outside array bounds, a 
ArraylndexOutOfBoundsException shall be thrown. 

5.2.4.3.1.3 Context errors 

• CRRCl : A ToolkitException.HANDLER_OVERFLOW shall be thrown if the ProactiveHandler is to small to 
put the requested data. 

5.2.4.3.2 Test area files 

Test Source: Test_Api_2_Pah_Ingk.java. 
Test Applet: Api_2_Pah_Ingk_l.java. 

Cap File: api_2_pah_ingk.cap. 
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5.2.4.3.3 



Test coverage 



CRR number 


Test case number 


N1 


8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20 


N2 


15 


N3 


17 


N4 


22 


N5 


7 


N6 


16 


P1 


1 


P2 


2, 3, 4, 5, 6 


C1 


21 



5.2.4.3.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


NULL as parameter to buffer 

initGetlnkey () 
buffer = NULL 


NullPointerException is thrown 




2 


offset > buffer.length 

initGetlnkey {) 
buffer = "Text" 
offset = 5 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


offset < 

initGetlnkey () 
buffer = "Text" 

offset = -1 


Array 1 ndexOutOfBou ndsExceptio 
n is thrown 




4 


length > buffer.length 

initGetlnkey () 
buffer = "Text" 
offset = 
length = 5 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


offset + length > buffer.length 

initGetlnkey {) 
buffer = "Text" 
offset = 3 
length = 2 


Array 1 ndexOutOfBou ndsExceptio 
n is thrown 




6 


length < 

initGetlnkey {) 
buffer = "Text" 
offset = 3 
length = -1 


Array 1 ndexOutOfBou ndsExceptio 
n is thrown 




7 


Successful call, buffer is the whole buffer 

initGetlnkey () 
qualifier = 
dcs = 4 

buffer = "TextA" 
offset = 
length = 5 


No exception is thrown 






Verify the command number value 


Command number between 01 h 
and FEh 




8 


Send the command 




GET INKEY Proactive 
command 

qualifier = OOh 

dcs = 4 

Text = "TextA" 


9 


Successful call, buffer is part of a buffer with 
the end part 

initGetlnkey () 
qualifier = 
dcs = 4 

buffer = "12TextB" 
offset = 2 
length = 5 




GET INKEY Proactive 
command 

qualifier = OOh 

dcs = 4 

Text = "TextB" 
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Id 


Description 


API Expectation 


APDU Expectation 


10 


Successful call, buffer is part of a buffer with 
the first part 

initGetlnkey () 
qualifier = 
dcs = 4 

buffer = "TextC12" 
offset = 
length = 5 




GET INKEY Proactive 
command 

qualifier = OOh 

dcs = 4 

Text = "TextC" 


11 


Successful call, buffer is part of a buffer 
Send the command 

initGetlnkey () 
qualifier = 

dcs = 4 

buffer = "12TextD34" 

offset = 2 

length = 5 




GET INKEY Proactive 
command 

qualifier = OOh 

dcs = 4 

Text = "TextD" 


12 


Successful call, qualifier = 81h 

initGetlnkey () 
qualifier = 81h 
dcs = 4 

buffer = "TextE" 
offset = 
length = 5 




GET INKEY Proactive 
command 

qualifier = Blh 

dcs = 4 

Text = "TextE" 


13 


Successful call, DCS=0 (7 bits) 

initGetlnkey () 
qualifier = 
dcs = 

buffer = "TextF" 
offset = 
length = 5 




GET INKEY Proactive 
command 

qualifier = OOh 

dcs = 

Text = "TextF" 


14 


Successful call, DCS=8 (UCS2) 

initGetlnkey () 
qualifier = 
dcs = 8 

buffer = "TextG" 
offset = 
length = 5 




GET INKEY Proactive 
command 

qualifier = OOh 

dcs = 8 

Text = "TextG" 


15 


Call the initGetlnkeyO method with any value 
Then build and send a GET INKEY command 

qualifier = 

dcs = 4 

buffer = "TextHTextH" 

offset = 

length = 10 




GET INKEY Proactive 
command 

qualifier = OOh 

dcs = 4 

Text = "TextHTextH" 


16 


Successful call, text length is zero 
Send the command 

initGetlnkey () 

qualifier = 

dcs = 4 

buffer = "TextHTextH" 

offset = 

length = 




GET INKEY Proactive 
command 

qualifier = OOh 

Text String TLV = 8D 00 


17 


Select a TLV in the ProactiveHandler 

Call the initGetlnkeyO method 

Call the getValueLengthO method 


UNAVAILABLE_ELEMENT 
ToolkitException is thrown by 
getValueLengthO 




18 


Successful call, buffer length = 7Eh 

initGetlnkey () 
qualifier = 
dcs = 4 

buffer = "UUU..." 
offset = 
length = 7Eh 




GET INKEY Proactive 
command 

Text String TLV = 
8D 7F 04 55 55... 


19 


Successful call, buffer length = 7Fh 

initGetlnkey {) 
qualifier = 
dcs = 4 

buffer = "UUU..." 
offset = 
length = 7Fh 




GET INKEY Proactive 
command 

Text String TLV = 8D 81 
80 04 55 55... 
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Id 


Description 


API Expectation 


APDU Expectation 


20 


Successful call, buffer length = 240 




GET INKEY Proactive 




initGetlnkey () 




command 




Qualifier = 








dcs = 4 




Text String TLV = 




buffer = "UUU..." 




8D 81 Fl 04 55 55... 




offset = 








length = 240 






21 


Call the initGetlnkeyO method with a too long 


HANDLER_OVERFLOW 






buffer 


ToolkitException is thrown 






qualifier = 








dcs = 4 








buffer = "XXXX..." 








offset = 








length = 241 






22 


Call the InitGetlnkeyO without sending the 




No proactive command shall 




command 




be sent expected status is 
'9000' 



5.2.4.4 Method initGetlnput 

Test Area Reference: Api_2_Pah_Ingp. 

5.2.4.4.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void initGetlnput (byte qualifier^. 

byte dcs, 
byte [ ] buffer, 
short offset, 
short length, 
short minRespLength, 
short maxRespLength) 
throws Java . lang. NullPointerException, 

Java . lang . ArraylndexOutOf BoundsException, 
ToolkitException 



5.2.4.4.1.1 



Normal execution 



CRRNl: The method shall build a GET INPUT proactive command in the ProactiveHandler, using qualifier, 
dcs, buffer, minRespLength and maxRespLength parameters. Comprehension Required flags are set. 

CRRN2: A call to this method clears the handler then initializes it. 

CRRN3: No TLV is selected after a call to the method. 

CRRN4: The GET INPUT command is not sent by the method. 

CRRN5: The Command Number may take any value between Olh and FEh. 

CRRN6: If length is equal to zero, then the Text String TLV inserted in the command is a null text string TLV 
as defined in TS 101 267 [15]. 

5.2.4.4.1 .2 Parameter errors 

• CRRPl: The method shall throw NullPointerException if buffer is null. 

• CRRP2: If offset or length or both would cause access outside array bounds, a 
ArraylndexOutOfBoundsException shall be thrown. 



5.2.4.4.1.3 



Context errors 



CRRCl: A ToolkitException.HANDLER_OVERFLOW shall be thrown if the ProactiveHandler is to small to 
put the requested data. 
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5.2.4.4.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.4.4.3 



Test area files 

Test_Api_2_Pah_Ingp.j ava. 
Api_2_Pah_Ingp_l .Java. 
api_2_pah_ingp.cap. 

Test coverage 



CRR number 


Test case number 


N1 


8,9, 10, 11, 12, 13, 14, 15, 16, 18, 19,20 


N2 


15 


N3 


17 


N4 


22 


N5 


7 


N6 


16 


P1 


1 


P2 


2, 3, 4, 5, 6 


CI 


21 



5.2.4.4.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


NULL as parameter to buffer 

InitGetlnput () 
buffer = NULL 


NullPointerException is thrown 




2 


offset > buffer.length 

initGetlnkey () 
buffer = "Text" 
offset = 5 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


Offset < 

initGetlnkey () 
buffer = "Text" 
offset = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


length > buffer.length 

initGetlnkey {) 
buffer = "Text" 
offset = 
length = 5 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


offset + length > buffer.length 

initGetlnkey () 
buffer = "Text" 
offset = 3 
length = 2 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


length < 

initGetlnkey () 
buffer = "Text" 
offset = 3 
length = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Successful call, buffer is the whole buffer 

initGetlnkey () 
qualifier = 
dcs = 4 

buffer = "TextA" 
offset = 
length = 5 
minRespLength = OOh 
maxRespLength = FFh 


No exception is thrown 






Verify the command number value 


Command number between 01 h 
and FEh 




8 


Send the command 




GET INPUT Proactive 
command 

qualifier = OOh 
dcs = 4 

Text = "TextA" 
Min Length = OOh 
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Id 


Description 


API Expectation 


APDU Expectation 








Max Length = FFh 


9 


Successful call, buffer is part of a buffer with 

the end part 

Send the command 

InitGetlnkey () 
qualifier = 
dcs = 4 

buffer = "12TextB" 
offset = 2 
length = 5 
minRespLength = lOh 
maxRespLength = FFh 




GET INPUT Proactive 
command 

qualifier = OOh 
dcs = 4 

Text = "TextB" 
Min Length = lOh 
Max Length = FFh 


10 


Successful call, buffer is part of a buffer with 

the first part 

Send the command 

initGetlnkey {) 
qualifier = 
dcs = 4 

buffer = "TextC12" 
offset = 
length = 5 
minRespLength = FFh 
maxRespLength = FFh 




GET INPUT Proactive 
command 

qualifier = OOh 
dcs = 4 

Text = "TextC" 
Min Length = FFh 
Max Length = FFh 


11 


Successful call, buffer is part of a buffer 
Send the command 

initGetlnkey () 




GET INPUT Proactive 
command 




qualifier = 

dcs = 4 

buffer = "12TextD34" 




qualifier = OOh 

dcs = 4 

Text = "TextD" 




offset = 2 
length = 5 
minRespLength = OOh 
maxRespLength = OOh 




Min Length = OOh 
Max Length = OOh 


12 


Successful call, qualifier = 81h 

initGetlnkey () 
qualifier = 81h 




GET INPUT Proactive 
command 




dcs = 4 

buffer = "TextE" 




qualifier = 81h 
dcs = 4 




offset = 
length = 5 
minRespLength = OOh 
maxRespLength = lOh 




Text = "TextE" 
Min Length = OOh 
Max Length = lOh 


13 


Successful call, DCS=0 (7 bits) 

initGetlnkey () 
qualifier = 




GET INPUT Proactive 
command 




dcs = 

buffer = "TextF" 




qualifier = OOh 
dcs = 




offset = 
length = 5 
minRespLength = lOh 
maxRespLength = lOh 




Text = "TextF" 
Min Length = lOh 
Max Length = lOh 


14 


Successful call, DCS=8 (UCS2) 

initGetlnkey () 
qualifier = 




GET INPUT Proactive 
command 




dcs = 8 

buffer = "TextG" 




qualifier = OOh 
dcs = 8 




offset = 
length = 5 
minRespLength = OOh 
maxRespLength = FFh 




Text = "TextG" 
Min Length = OOh 
Max Length = FFh 


15 


Call the initGetlnputO method with any value 
Then build and send a GET INPUT command 




GET INPUT Proactive 
command 




qualifier = 
dcs = 4 




qualifier = OOh 




buffer = "TextHTextH" 




dcs = 4 




offset = 
length = 10 
minRespLength = OOh 
maxRespLength = lOh 




Text = "TextHTextH" 
Min Length = OOh 
Max Length = lOh 
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Id 


Description 


API Expectation 


APDU Expectation 


16 


Successful call, text length is zero 




GET INPUT Proactive 




Send the command 




command 




initGetlnkey () 








qualifier = 




qualifier = OOh 




dcs = 4 




Text String TLV = 8D 00 




buffer = "TextHTextH" 




Min Length = OOh 




offset = 




Max Length = lOh 




length = 








minRespLength = OOh 








maxRespLength = lOh 






17 


Select a TLV in the ProactiveHandler 


UNAVAILABLE_ELEMENT 






Call the initGetlnputO method 


ToolkitException is thrown by 






Call the getValueLengthO method 


getValueLengthO 




18 


Successful call, buffer length = 7Eh 




GET INPUT Proactive 




initGetlnkey qualifier = 




command 




dcs = 4 








buffer = "UUU..." 




Text String TLV = 




offset = 




8D 7F 04 55 55... 




length = 7Eh 




Min Length = OOh 




minRespLength = OOh 




Max Length = lOh 




maxRespLength = lOh 






19 


Successful call, buffer length = 7Fh 




GET INPUT Proactive 




initGetlnkey () 




command 




qualifier = 








dcs = 4 




Text String TLV = 8D 81 




buffer = "UUU..." 




80 04 55 55... 




offset = 




Min Length = OOh 




length = 7Fh 




Max Length = lOh 




minRespLength = OOh 








maxRespLength = lOh 






20 


Successful call, buffer length = 236 




GET INPUT Proactive 




initGetlnkey () 




command 




Qualifier = 








dcs = 4 




Text String TLV = 




buffer = "UUU..." 




8D 81 ED 04 55 55... 




offset = 








length = 236 








minRespLength = OOh 








maxRespLength = lOh 






21 


Call the InitGetlnputO method with a too long 


HANDLER_OVERFLOW 






buffer 


ToolkitException is thrown 






qualifier = 








dcs = 4 








buffer = "XXXX..." 








offset = 








length = 237 








minRespLength = OOh 








maxRespLength = lOh 






22 


Call the InitGetlnputO without sending the 




No proactive command shall 




command 




be sent expected status is 
'9000' 



5.2.4.5 Method send 

Test Area Reference: Api_2_Pah_Send. 

5.2.4.5.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte sendO 

5.2.4.5.1.1 Normal execution 

• CRRNl: The send() method send the current proactive command to the mobile. 

• CRRN2: The returned byte is equal to general result of the command (first byte of Result TLV in Terminal 
Response). 



ETSI 



Release 6 



208 



ETSI TS 102 268 V6.0.0 (2007-03) 



• CRRN3: The handler remains unchanged after a call to send() method until the use of initXX() or 
appendTLV(). 

• CRRN4: There is no invocation of select() or deselect() method. 

• CRRN5: A pending toolkit applet transaction at the method invocation is aborted. 

5.2.4.5.1 .2 Parameter errors 
No requirements. 

5.2.4.5.1 .3 Context errors 

• CRRC 1 : A ToolkitException.UNAVAILABLE_ELEMENT shall be thrown is the Result Comprehension 
TLV is missing in Terminal Response. 

• CRRC2: A ToolkitException.OUT_OF_TLV_BOUND ARIES shall be thrown if the general result byte is 
missing in the Result Comprehension TLV in Terminal Response. 

• CRRC3: A ToolkitException.COMMAND_NOT_ALLOWED shall be thrown if the proactive command to be 
sent is not allowed by the CAT Runtime Environment. 

• CRRC4: A ToolkitException.COMMAND_NOT_ALLOWED shall be thrown if one parameter of the 
proactive command to be sent is not allowed by the CAT Runtime Environment. 



5.2.4.5.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.4.5.3 



Test area files 

Test_Api_2_Pah_Send.j ava. 
Api_2_Pah_Send_l .Java. 
api_2_pah_send.cap. 

Test coverage 



CRR number 


Test case number 


N1 


1,3,5,7,9, 10, 11, 12, 13, 14 


N2 


2,4, 6,8, 14 


N3 


12 


N4 


13 


N5 


checked in the CAT Runtime Environment test : Ore Api Iran (test case 1) 


C1 


15 


C2 


16 


C3 


checl<ed in the GAT Runtime Environment test : Fwl< Pes Pcco (test case 1) 


C4 


checl<ed in the GAT Runtime Environment test : Fwk Pes Pcco (test cases 2 to 3) 



5.2.4.5.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Build and send a DISPLAY TEXT command 

qualifier = OOh 
dcs = 04h 
buffer = 'Text' 




DISPLAY TEXT Proactive 
command 


2 


Terminal Response with General Result = 00 

Result TLV = 03 01 00 (command performed 
successfully) 


Result of sendO is OOh 




3 


Build and send a DISPLAY TEXT command 

qualifier = OOh 
dcs = 04h 
buffer = 'Text' 




DISPLAY TEXT Proactive 
command 


4 


Terminal Response with General Result = 01, 
without Additional information on result 


Result of send() is 01 h 
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Id 


Description 


API Expectation 


APDU Expectation 




Result TLV = 03 01 01 (command performed 
with partial comprehension) 






5 


Build and send a DISPLAY TEXT command 

qualifier = OOh 
dcs = 04h 
buffer = 'Text' 




DISPLAY TEXT Proactive 
command 


6 


Terminal Response with General Result = 01, 
with Additional information on result 

Result TLV = 03 02 01 55 (command 
performed with partial comprehension) 


Result of send() is 01 h 




7 


Build and send a DISPLAY TEXT command 

qualifier = OOh 
dcs = 04h 
buffer = 'Text' 




DISPLAY TEXT Proactive 
command 


8 


Terminal Response with General Result = 02 

Result TLV = 03 04 02 65 43 21 (Missing 
information) 


Result of sendO is 02h 




9 


Build and send a 7Fh byte command 
(DISPLAY TEXT) 

qualifier = OOh 
dcs = 04h 
buffer = "UUUUU..." 
length = 73h 




DISPLAY TEXT Proactive 
command 

BER-TLV = DO 7F 

Text String TLV = 8D 74 

04 55 55 55... 


10 


Build and send a 80h byte command (DISPLAY 
TEXT) 

qualifier = OOh 
dcs = 04h 
buffer = "UUUUU..." 
length = 74h 




DISPLAY TEXT Proactive 
command 

BER-TLV = DO 81 80 
Text String TLV = 8D 75 

04 55 55 55... 


11 


Build and send a maximum length command 
(length of the handler should be 253) 

DISPLAY TEXT: 
Qualifier = 
dcs = 4 

buffer = "UUU..." 
offset = 
length = 240 




DISPLAY TEXT Proactive 
command 

BER-TLV = DO 81 FD 
Text String TLV = 8D 81 

Fl 04 55 55... 


12 


Verify that the Proactive Handler is not 

modified after a send() 

Build a DISPLAY TEXT command 

Copy ProactiveHandler to source byte array 

Send command 

Copy ProactiveHandler to destination byte 
array 

Compare source and destination 


Source and destination are 
identical 




13 


Build and send a DISPLAY TEXT command 

Verify there is no invocation of select() or 

deselectO method. 




DISPLAY TEXT Proactive 
command 


14 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with 2 Result TLV 

1st Result TLV = 03 02 02 12 
2nd Result TLV = 03 03 03 34 56 


Result of sendO is 02h 




15 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response without Result 
Comprehension TLV 


ToolkitException.UNAVAILABLE_ 
ELEMENT is thrown by send() 
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Id 


Description 


API Expectation 


APDU Expectation 


16 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response without general result byte 
in the Comprehension TLV 

Result TLV = 03 00 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown by 
send{) 





5.2.4.6 Method getLength 

Test Area Reference Api_2_Pah_Glen. 

5.2.4.6.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getLength () 

throws ToolkitException 

5.2.4.6.1.1 Normal execution 

• CRRNl : returns the length in bytes of the TLV list. 

5.2.4.6.1 .2 Parameter errors 
No requirements. 

5.2.4.6.1 .3 Context errors 

• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 



5.2.4.6.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.4.6.3 



Test area files 

Test_Api_2_Pah_Glen.j ava 
Api_2_Pah_Glen_l .Java. 
api_2_pah_glen.cap. 

Test coverage 



CRR number 


Test case number 


N1 


1,2,3,4,5 


C1 


Does not apply for Proactive Handler 



5.2.4.6.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Clear the handler 

getLength ( ) 


Result of getLengthQ is 




2 


Call the initO method 

getLength ( ) 


Result of getLengthO is 9 




3 


Call the InitDisplayTextO method, with buffer 
length = 240 

getLength () 


Result of getLengthO is 253 
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Id 


Description 


API Expectation 


APDU Expectation 


4 


Build a 7Fh Proactive Handler 

getLength ( ) 


Result of getLengthQ is 7Fh 




5 


Build a 80h Proactive Handler 

getLength ( ) 


Result of getLengthQ is 80h 





5.2.4.7 Method copy 

Test Area Reference Api_2_Pah_Copy. 

5.2.4.7.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short copy (byte [] dstBuffer, 
short dstOffset, 
short dstLength) 
throws Java . lang . NullPointerException, 

Java .lang . Array I ndexOut Of Bounds Exception^ 
ToolkitException 

5.2.4.7.1.1 Normal execution 

• CRRNl: copies the Comprehension TLV list contained in the handler to the destination byte array. 

• CRRN2: returns dstOffset + dstLength. 

5.2.4.7.1 .2 Parameter errors 

• CRRP 1 : if dstBuffer is null a NullPointerException is thrown. 

• CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative, 
an ArraylndexOutOfBoundsException is thrown. 

• CRRP3: if dstLength is grater than the length of the Comprehension TLV List, an instance of 
ToolkitException shall be thrown. The reason code shall be 
ToolkitException.OUT_OF_TLV_BOUND ARIES. 



5.2.4.7.1.3 



Context errors 



CRRCl; if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 



5.2.4.7.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.4.7.3 



Test area files 

Test_Api_2_Pah_Copy.j ava. 
Api_2_Pah_Copy_l .j ava. 
api_2_pah_copy.cap. 

Test coverage 



CRR number 


Test case number 


N1 


9, 11, 13 


N2 


8, 10, 12 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7 


C1 


Does not apply for ProactiveHandler 
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5.2.4.7.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


NULL as parameter to dstBuffer 


NullPointerException is thrown 




2 


Call the initQ method 








DstOffset > dstBuffer.length 

copy 

dstBuffer.length = 5 
dstOffset = 6 
dstLength = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


dstOffset < 

copy {) 

dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


DstLength > dstBuffer.length 

copy {) 

dstBuffer.length = 5 
dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + dstLength > dstBuffer.length 

copy 

dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


dstLength < 

copy 

dstBuffer.length = 5 
dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


dstLength > length of the Comprehension TLV 
list 

copy 

dstBuffer.length = 10 
dstOffset = 
dstLength = 10 


Tooll<itExGeption.OUT OF TLV 
BOUNDARIES is thrown 




8 


Successful call, dstBuffer is the whole buffer 

copy 

dstBuffer.length = 9 
dstOffset = 
dstLength = 9 


Result of copyO is 9 




9 


Compare the buffer 


Result of arrayCompareO is 




10 


Successful call, dstBuffer is part of a buffer 

copy 

dstBuffer.length = 15 
dstOffset = 3 
dstLength = 9 


Result of copyO is 12 




11 


Compare the whole buffer 


Result of arrayCompareO is 




12 


Successful call, dstBuffer is part of a buffer 

copy 

dstBuffer.length = 15 
dstOffset = 3 
dstLength = 6 


Result of copyO is 9 




13 


Compare the whole buffer 


Result of arrayCompareO is 





5.2.4.8 Method findTLV 

Test Area Reference Api_2_Pah_Find. 

5.2.4.8.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte findTLV (byte tag, 

byte occurrence) 
throws ToolkitException 
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5.2.4.8.1.1 Normal execution 

Looks for the indicated occurrence of a TLV element from the beginning of the TLV Hst (handler buffer): 

• CRRNl: the method is successful if the required occurrence exists then the corresponding TLV becomes 
current. 

• CRRN2: if the method is successful then it returns TLV_FOUND_CR_SET when Comprehension Required 
flag is set. 

• CRRN3: if the method is successful then it returns TLV_FOUND_CR_NOT_SET when Comprehension 
Required flag is not set. 

• CRRN4: if the required occurrence of the TLV element does not exist, the current TLV is no longer defined 
and TLV_NOT_FOUND is returned. 

• CRRN5: The search method is comprehension required flag independent. 

5.2.4.8.1 .2 Parameter errors 

• CRRP 1 : if an input parameter is not valid (e.g. occurrence = 0) an instance of TooMtException shall be 
thrown. The reason code shall be ToolkitException.BAD_INPUT_PARAMETER. 



5.2.4.8.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 



5.2.4.8.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.4.8.4 



Test area files 

Test_Api_2_Pah_Find.j ava. 
Api_2_Pah_Find_ Lj ava. 
api_2_pah_find.cap. 

Test coverage 



CRR number 


Test case number 


N1 


3,5 


N2 


2,4 


N3 


10, 11 


N4 


6, 7,8, 9 


N5 


12, 13 


P1 


1 


C1 


Does not apply for Proactive Handler 



5.2.4.8.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Initialize the handler 








Invalid input parameter 

findTLVO 
Occurrence = 


ToolkitException. BAD_INPUT_PA 
RAMETER is thrown 




2 


Call the initQ method 








Search 1st TLV 

findTLVO 
Tag = Olh 
Occurrence = 1 


Result Is TLV_FOUND_CR_SET 




3 


Call the getValueLengthO method 


Result is 03h 




4 


Search 2nd TLV 

findTLVO 
Tag = 02h 
Occurrence = 1 


Result is TLV_FOUND_CR_SET 
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5 


Call the getValueLengthO method 


Result is 02h 




6 


Select a TLV (tag 02h) 








Search a wrong tag 

findTLVO 
Tag = 03h 
Occurrence = 1 


Result is TLV_NOT_FOUND 




7 


Call the getValueLengthO method 


Tooll<itException. UNAVAILABLE 
ELEIVIENT Is thrown. 




8 


Search a tag with wrong occurrence 

findTLVO 
Tag = Olh 
Occurrence = 2 


Result is TLV_NOT_FOUND 




9 


Call the getValueLengthO method 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown. 




10 


Append a TLV with tag=02h 








Search the TLV 

findTLVO 
Tag = 02h 
Occurrence = 2 


Result is 
TLV_FOUND_CR_NOT_SET 




11 


Append a TLV with tag=04h 








Search the TLV 

findTLVO 
Tag = 04h 
Occurrence = 1 


Result is 
TLV_FOUND_CR_NOT_SET 




12 


Search tag 81 h 

findTLVO 
Tag = 81h 
Occurrence = 1 


Result is TLV_FOUND_CR_SET 




13 


Search tag 84h 

findTLVO 
Tag = 84h 
Occurrence = 1 


Result is 
TLV_FOUND_CR_NOT_SET 





5.2.4.9 Method getValueLength 

Test Area Reference Api_2_Pah_Gvle. 

5.2.4.9.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getValueLength ( ) 

throws ToolkitException 



5.2.4.9.1.1 



Normal execution 



• CRRNl : gets and returns the binary length of the value field for the last TLV element which has been found in 
the handler. 



5.2.4.9.1.2 

No requirements. 

5.2.4.9.1.3 



Parameter errors 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

• CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException.UNAVAILABLE_ELEMENT. 
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5.2.4.9.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.4.9.3 



Test area files 

Test_Api_2_Pah_Gvle.java. 
Api_2_Pah_Gvle_l .Java. 
api_2_pah_gvle.cap. 

Test coverage 



CRR number 


Test case number 


N1 


2,3,4,5,6 


C1 


Does not apply for Proactive Handler 


C2 


1 



5.2.4.9.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call the initO method 








getValueLength ( ) 


ToolkitException . UNAVAI LABLE 
ELEMENT is thrown 




2 


Call the appendTLVO method 

tag = OD 
valueOffset = 
valueLength = 








Search TLV ODh (Text String TLV) 








getValueLength ( ) 


Result is OOh 




3 


Call the InitDlsplayTextO method 

length = 1 (+ dcs byte) 








Search TLV ODh (Text String TLV) 








getValueLength ( ) 


Result is 02h 




4 


Call the InitDlsplayTextO method 
length = 7Eh (+ dcs byte) 








Search TLV ODh (Text String TLV) 








getValueLength ( ) 


Result is 7Fh 




5 


Call the InitDisplayTextO method 

length = 7Fh (+ dcs byte) 








Search TLV ODh (Text String TLV) 








getValueLength ( ) 


Result is 80h 




6 


Call the InitDisplayTextO method 

length = FOh (maximum text length) 








Search TLV ODh (Text String TLV) 








getValueLength ( ) 


Result is F1h 





5.2.4.10 Method getValueByte 

Test Area Reference Api_2_Pah_Gvby. 

5.2.4.10.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte getValueByte (short valueOffset) 
throws ToolkitException 



5.2.4.10.1.1 



Normal execution 



CRRNl: Gets a byte from the last TLV element which has been found in the handler and returns its value (1 
byte). 
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5.2.4.10.1.2 



Parameter errors 



• CRRP 1 : if valueOffset is out of the current TLV an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException.OUT_OF_TLV_BOUND ARIES. 



5.2.4.10.1.3 



Context errors 



CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException.UNAVAILABLE_ELEMENT. 



5.2.4.10.2 

Test Source: 
Test Applet: 
Cap File: 



Test area files 

Test_Api_2_Pah_Gvby.j ava. 
Api_2_Pah_Gvby_ 1 .j ava. 
api_2_pah_gvby.cap. 



5.2.4.10.3 



Test coverage 



CRR number 


Test case number 


N1 


3,4,5,6,7,8 


P1 


2 


C1 


Does not apply for Proactive Handler 


C2 


1 



5.2.4.10.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call the initO method 

type = FFh 
qualifier = FEh 
destination = FDh 








getValueByte(O) 


ToolkitException. UNAVAILABLE 
ELEIVIENT is thrown 




2 


Search TLV 01 h (Command Details TLV) 








getValueByte(3) 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




3 


Search TLV 01 h (Command Details TLV) 








getValueByte(2) 


Result is FEh (qualifier) 




4 


Search TLV 02h (Device Identities TLV) 








getValueByte(O) 


Result is 81 h (Source) 




5 


InitDisplayTextQ 

buffer = 00 01 ... 7D 

length = 7Eh 

Search TLV ODh (Text String TLV) 








getValueByte(7E) 


Result is 7Dh 




6 


InitDisplayTextQ 

buffer = 00 01 ... 7D 7E 

length = 7Fh 

Search TLV ODh (Text String TLV) 








getValueByte(7E) 


Result is 7Dh 




7 


getValueByte(7F) 


Result is 7Eh 
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Id 


Description 


API Expectation 


APDU Expectation 


8 


InitDlsplayTextO 

buffer = 00 01 ... EF 

length = FOh 

Search TLV ODh (Text String TLV) 








getValueByte(FO) 


Result is EFh 





5.2.4.11 Method copyValue 

Test Area Reference Api_2_Pah_Cpyv 



5.2.4.11.1 



Conformance requirement 



The method with following header shall be compliant with its definition in the API. 

public short copyValue (short valueOffset, 

byte[] dstBuffer, 
short dstOffset, 
short dstLength) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException^ 
ToolkitException 

5.2.4.1 1 .1 .1 Normal execution 

• CRRNl : copies a part of the last TLV element which has been found, into a destination, buffer. 

• CRRN2: returns dstOffset + dstLength. 

5.2.4.11.1.2 Parameter errors 

• CRRP 1 : if dstBuffer is null NullPointerException is thrown. 

• CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative 
ArraylndexOutOfBoundsException is thrown. 

• CRRP3: if valueOffset is negative or valueOffset + dstLength > current TLV length, an instance of 
ToolkitException shall be thrown. The reason code shall be 
ToolkitException.OUT_OF_TLV_BOUND ARIES. 



5.2.4.11.1.3 



Context errors 



CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException.UNAVAILABLE_ELEMENT. 



5.2.4.11.2 

Test Source: 
Test Applet: 
Cap File: 



Test area files 

Test_Api_2_Pah_Cpyv.j ava. 
Api_2_Pah_Cpyv_l.java. 
api_2_p ah_cpy V . c ap . 
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5.2.4.11.3 



Test coverage 



CRR number 


Test case number 


N1 


13,15 


N2 


12, 14 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7,8,9,10 


C1 


Does not apply for Proactive Handler 


C2 


11 



5.2.4.11.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Initialize the handler 
Select a TLV 








copyValueO with a null dstBuffer 


NullPointerException is thrown 




2 


InitDisplayTextO with length = 15 

Select Text String TLV 








dstOffset > dstBuffer.length 

copyValue () 
dstBuffer.length = 5 
dstOffset = 6 
dstLength = 


Array 1 ndexOutOfBou ndsExceptio 
n is thrown 




3 


dstOffset < 

copyValue () 
dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


dstLength >dstBuffer.length 

copyValue () 
dstBuffer.length = 5 
dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + dstLength >dstBuffer.length 

copyValue () 
dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


dstLength < 

copyValue () 
dstBuffer.length = 5 
dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


InitDisplayTextO with length = 5 

Select Text String TLV 








valueOffset > Text String Length 

copyValue () 
valueOffset = 7 
dstBuffer.length = 15 
dstOffset = 
dstLength = 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


[Select Text String TLV] 

valueOffset < 
copyValue () 
valueOffset = -1 
dstBuffer.length = 15 
dstOffset = 
dstLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


[Select Text String TLV] 

dstLength > Text String length 
copyValue () 
valueOffset = 
dstBuffer.length = 15 
dstOffset = 
dstLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


10 


[Select Text String TLV] 

valueOffset + dstLength > Text String 

length 

copyValue ( ) 

valueOffset = 2 

dstBuffer. length = 15 

dstOffset = 

dstLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Initialize the handler 








copyValueO 


ToolkitException.UNAVAILABLE_ 
ELEMENT is thrown 




12 


InitDlsplayTextO 

dcs = 4 

buffer = 00 01 ... OF 

Select Text String TLV 








Successful call 

copyValue () 
valueOffset = 
dstBuffer .length = 17 
dstOffset = 
dstLength = 17 


Result of copyValueO is 17 




13 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




14 


Initialize dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

copyValue ( ) 
valueOffset = 2 
dstBuffer. length = 20 
dstOffset = 3 
dstLength = 12 


Result of copyValueO is 15 




15 


Compare buffer 

buffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 


Result is OOh 





5.2.4.12 Method compareValue 

Test Area Reference Api_2_Pah_Cprv. 



5.2.4.12.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

public byte compareValue (short valueOffset, 

byte[] compareBuf fer, 
short compareOf f set, 
short compareLength) 
throws Java . lang . NullPointerException, 

Java .lang . Array I ndexOut Of Bounds Except ion, 
ToolkitException 

5.2.4.12.1.1 Normal execution 

Compares the last found TLV element with a buffer: 

• CRRN 1 : returns if identical. 

• CRRN2: returns -1 if the first miscomparing byte in Comprehension TLV List is less than that in 
compareBuffer. 

• CRRN3: returns 1 if the first miscomparing byte in Comprehension TLV List is greater than that in 
compareBuffer. 
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5.2.4.12.1.2 Parameter errors 

• CRRPl: if compareBuffer is null NullPointerException shall be thrown. 

• CRRP2: if compareOffset or compareLength or both would cause access outside array bounds, or if 
compareLength is negative ArraylndexOutOfBoundsException shall be thrown. 

• CRRP3: if valueOffset is negative or valueOffset + dstLength > current TLV length, an instance of 
ToolkitException shall be thrown. The reason code shall be 
ToolkitException.OUT_OF_TLV_BOUND ARIES. 



5.2.4.12.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

• CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException.UNAVAILABLE_ELEMENT. 



5.2.4.12.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.4.12.3 



Test area files 

Test_Api_2_Pah_Cprv.j ava. 
Api_2_Pah_Cprv_ Lj ava. 
api_2_pah_cprv. cap . 

Test coverage 



CRR number 


Test case number 


N1 


12, 15 


N2 


13, 16 


N3 


14, 17, 18 


P1 


1 


P2 


2,3,4,5,6 


P3 


7,8,9, 10 


01 


Does not apply for Proactive Handler 


C2 


11 



5.2.4.12.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Initialize the handler 
Select a TLV 








compareValueQ with a null compareBuffer 


NullPointerException is thrown 




2 


InitDisplayTextO with length = 15 

Select Text String TLV 








compareOffset > compareBuffer.length 

compareValue () 
compareBuffer.length = 5 
compareOffset = 6 
compareLength = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


compareOffset < 

compareValue () 
compareBuffer.length = 5 
compareOffset = -1 
compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


compareLength >compareBuffer.length 

compareValue ( ) 
compareBuffer.length = 5 
compareOffset = 
compareLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


5 


compareOffset + compareLength 
>compareBuffer.length 

compareValue () 
compareBuffer . length = 5 
compareOffset = 3 
compareLength = 3 


Array 1 ndexOutOfBou ndsExceptio 
n is tfirown 




6 


compareLength < 

compareValue () 

compareBuffer.length = 5 
compareOffset = 
compareLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


inltDisplayTextO with length = 5 
Select Text String TLV 








valueOffset > Text String Length 

compareValue ( ) 
valueOffset = 7 
compareBuffer.length = 15 
compareOffset = 
compareLength = 


Tooll<itException.OUT OF TLV 
BOUNDARIES is thrown 




8 


[Select Text String TLV] 

valueOffset < 
compareValue ( ) 
valueOffset = -1 
compareBuffer.length = 15 
compareOffset = 
compareLength = 1 


Tooll<itException.OUT OF TLV 
BOUNDARIES is thrown 




9 


[Select Text String TLV] 

compareLength > Text String length 
compareValue () 
valueOffset = 
compareBuffer.length = 15 
compareOffset = 
compareLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


[Select Text String TLV] 

valueOffset + compareLength > Text String 

length 

compareValue () 

valueOffset = 2 

compareBuffer.length = 15 

compareOffset = 

compareLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Initialize the handler 








compareValueO 


ToolkitException. UNAVAILABLE 
ELEIVIENT is thrown 




12 


inltDisplayTextO 

dcs = 4 

buffer = 00 01 ... OF 

Select Text String TLV 








Initialize compareBuffer 

compareBuffer = 
04 00 01 ... OF 








Compare buffers 

compareValue () 
valueOffset = 
compareOffset = 
compareLength = 17 


Result is OOh 




13 


Initialize compareBuffer 

compareBuffer = 
04 00 01 02 03 

04 05 06 07 08 

05 OA OB OC OD 
OE 10 








Compare buffers with same parameters 


Result is -1 




14 


Initialize compareBuffer 

compareBuffer = 
03 00 01 ... OF 








Compare buffers with same parameters 


Result is +1 
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Id 


Description 


API Expectation 


APDU Expectation 


15 


Initialize compareBuffer 

compareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 








Compare buffers 

compareValue ( ) 
valueOffset = 2 
compareOf f set = 3 
compareLength = 12 


Result is OOh 




16 


Initialize compareBuffer 

compareBuffer = 
55 55 55 02 01 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 








Compare buffers with same parameters 


Result is -1 




17 


Initialize compareBuffer 

compareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OA OD 
55 55 55 55 55 








Compare buffers with same parameters 


Result is +1 




18 


Initialize compareBuffer 

compareBuffer = 
55 55 55 99 03 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 








Compare buffers with same parameters 


Result is +1 





5.2.4.1 3 Method findAndCopyValue(byte tag, byteQ dstBuffer, short valueOffset) 

Test Area Reference Api_2_Pah_Facyb_Bs. 

5.2.4.13.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short f indAndCopyValue (byte tag, 

byte[] dstBuffer, 
short dstOffset) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
ToolkitException 



5.2.4.13.1.1 



Normal execution 



• CRRN 1 : looks for the first occurrence of a TLV element from the beginning of a TLV list and copy its value 
into a destination buffer. 

• CRRN2: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current 
TLV is no longer defined. 

• CRRN3: if the method is successful then the corresponding TLV becomes current and dstOffset + length of 
the copied value is returned. 

• CRRN4: The search method is comprehension required flag independent. 
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5.2.4.13.1.2 Parameter errors 

• CRRP 1 : if dstBuffer is null NullPointerException shall be thrown. 

• CRRP2: if dstOffset would cause access outside array bounds ArraylndexOutOfBoundsException shall be 
thrown. 



5.2.4.13.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 



5.2.4.13.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.4.13.3 



Test area files 

Test_Api_2_Pah_Facyb_Bs.java. 
Api_2_Pah_Facyb_B s_ 1 .j ava. 
api_2_pah_facyb_bs.cap. 

Test coverage 



CRR number 


Test case number 


N1 


8, 10, 12 


N2 


6 


N3 


7, 9, 11 


N4 


13, 14, 15, 16 


P1 


1 


P2 


2,3,4,5 


C1 


Does not apply for Proactive Handler 



5.2.4.13.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Initialize the handler 








FindAndCopyValueO with a null dstBuffer 


NullPointerException is thrown 




2 


InitDisplayTextO with length = 15 








dstOffset > dstBuffer.length 

findAndCopyValue () 
tag = ODh 

dstBuffer.length = 20 
dstOffset = 21 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


dstOffset < 

findAndCopyValue () 
dstBuffer.length = 20 
dstOffset = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


length > dstBuffer.length 

findAndCopyValue () 
dstBuffer.length = 15 
dstOffset = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


DstOffset + length >dstBuffer.length 

findAndCopyValue {) 
DstBuffer.length = 20 

DstOffset = 5 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


InitDisplayTextO 








Select a TLV (tag 02h) 








findAndCopyValueO 

tag = 03h 


ToolkitException. UNAVAILABLE_ 
ELEMENT is thrown 






Call the getValueLengthO method 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown. 
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Id 


Description 


API Expectation 


APDU Expectation 


7 


InitDlsplayTextO 

dcs = 4 

buffer = 00 01 ... OF 








Successful call 

findAndCopyValue () 
Tag = ODh 

DstBuffer. length = 17 
DstOffset = 


Result of finclAndcopyValueO is 
17 




8 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




9 


Initialize dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

findAndCopyValue () 
dstBuffer .length = 20 
dstOffset = 2 


Result of fincJAndcopyValueO is 
19 




10 


Compare buffer 

buffer = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 


Result is OOh 




11 


InitDlsplayTextO 

dcs = 4 

buffer = 00 01 ... OF 








append a 2nd Text String TLV 








Successful call 

findAndCopyValue () 
tag = ODh 

dstBuffer. length = 17 
dstOffset = 


Result of fincJAndcopyValueO is 
17 




12 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




13 


initDisplayTextO 

dcs = 4 

buffer = 00 01 ... OF 








Successful call (with tag 8Dh) 

findAndCopyValue () 
tag = 8Dh 

dstBuffer. length = 17 
dstOffset = 


Result of findAndcopyValueO is 
17 




14 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




15 


Append tag OFh 

buffer = 00 01 ... OF 








Successful call (with tag BFh) 

findAndCopyValue () 
tag = 8Fh 

dstBuffer . length = 16 
dstOffset = 


Result of findAndcopyValueO is 
16 




16 


Compare buffer 

buffer = 00 01 ... OF 


Result is OOh 
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5.2.4.14 Method findAndCopyValue(byte tag, byte occurrence, short valueOffset, 
byte[] dstBuffer, short dstOffset, short dstLength) 

Test Area Reference Api_2_Pah_Facybbs_Bss. 

5.2.4.14.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short f indAndCopyValue (byte tag, 

byte occurrence, 
short valueOffset, 
byte[l dstBuffer, 
short dstOffset, 
short dstLength) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
ToolkitException 

5.2.4.14.1.1 Normal execution 

• CRRNl: looks for the indicated occurrence of a TLV element from the beginning of a TLV list and copy its 
value into a destination buffer. 

• CRRN2: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current 
TLV is no longer defined. 

• CRRN3: if the method is successful then the corresponding TLV becomes current and dstOffset + dstLength is 
returned. 

• CRRN4: The search method is comprehension required flag independent. 

5.2.4.14.1 .2 Parameter errors 

• CRRP 1 : if dstBuffer is null NullPointerException shall be thrown. 

• CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative 
ArraylndexOutOfBoundsException shall be thrown. 

• CRRP3: if valueOffset is negative or valueOffset + dstLength > current TLV length, an instance of 
ToolkitException shall be thrown. The reason code shall be 
ToolkitException.OUT_OF_TLV_BOUND ARIES. 

• CRRP4: if an input parameter is not valid (e.g. occurrence = 0) an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException.BAD_INPUT_PARAMETER. 

5.2.4.14.1.3 Context errors 

• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

5.2.4.14.2 Test area files 

Test Source: Test_Api_2_Pah_Facybbs_Bss.java. 
Test Applet: Api_2_Pah_Facybbs_Bss_l.java. 

Cap File: api_2_pah_facybbs_bss.cap. 



ETSI 



Release 6 



226 



ETSI TS 102 268 V6.0.0 (2007-03) 



5.2.4.14.3 



Test coverage 



CRR number 


Test case number 


N1 


13, 15, 17, 19 


N2 


11 


N3 


12, 14, 16, 18 


N4 


20,21,22,23 


P1 


1 


P2 


2,3,4,5,6 


P3 


7,8,9, 10 


P4 


24 


C1 


Does not apply for ProactiveHandler 



5.2.4.14.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Initialize the handler 








findAndCopyValueO with a null dstBuffer 


NullPointerException is thrown 




2 


InitDisplayTextO with length = 15 








dstOffset > dstBuffer.length 

f indAndCopyValue () 

tag = ODh, occurrence = 1 

valueOffset = 

dstBuffer.length = 5 

dstOffset = 6 

dstLength = 


Array 1 ndexOutOfBou ndsExceptio 
n is thrown 




3 


dstOffset < 

f indAndCopyValue () 
dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


dstLength >dstBuffer.length 

f IndAndCopyValue {) 
dstBuffer.length = 5 
dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + dstLength >dstBuffer.length 

f IndAndCopyValue () 
dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


dstLength < 

f indAndCopyValue () 
dstBuffer.length = 5 
dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


InitDisplayTextO with length = 5 








valueOffset > Text String Length 

f IndAndCopyValue () 

tag = ODh, occurrence = 1 

valueOffset = 7 

dstBuffer.length = 15 

dstOffset = 

dstLength = 


Tooll<itException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

f IndAndCopyValue () 
valueOffset = -1 
dstBuffer.length = 15 
dstOffset = 
dstLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


dstLength > Text String length 

f IndAndCopyValue () 
valueOffset = 
dstBuffer.length = 15 
dstOffset = 
dstLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 





ETSI 



Release 6 



227 



ETSI TS 102 268 V6.0.0 (2007-03) 



Id 


Description 


API Expectation 


APDU Expectation 


10 


valueOffset + dstLength > Text String length 

f IndAndCopyValue () 
valueOffset = 2 
dstBuffer .length = 15 
dstOffset = 
dstLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


InitDisplayTextQ 








Select a TLV (tag 02h) 








findAndCopyValueO 

tag = ODh 
occurrence = 2 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown 






Call the getValueLengthO method 


ToolkitException. UNAVAILABLE_ 
ELEIVIENT is thrown. 




12 


InitDisplayTextO 

dcs = 4 

buffer = 00 01 ... OF 








Successful call 

f IndAndCopyValue () 

tag = ODh, occurrence = 1 

valueOffset = 

dstBuffer. length = 17 

dstOffset = 

dstLength = 17 


Result of findAndCopyValueQ is 
17 




13 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




14 


Initialize dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

f IndAndCopyValue () 

tag = ODh, occurrence = 1 

valueOffset = 2 

dstBuffer. length = 20 

dstOffset = 3 

dstLength = 12 


Result of findAndcopyValueO is 
15 




15 


Compare buffer 

buffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 


Result is OOh 




16 


Append a Text String TLV 

tag = OD 

buffer = 00 11 22 33 44 55 (no specific 

DCS byte) 








Successful call 

f IndAndCopyValue () 

tag = ODh, occurrence = 1 

valueOffset = 

dstBuffer .length = 17 

dstOffset = 

dstLength =17 


Result of findAndCopyValueQ is 
17 




17 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




18 


Successful call 

f IndAndCopyValue () 

tag = ODh, occurrence = 2 

valueOffset = 

dstBuffer . length = 6 

dstOffset = 

dstLength = 6 


Result of findAndCopyValueQ is 6 




19 


Compare buffer 

buffer = 00 11 22 33 44 55 


Result is OOh 
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Id 


Description 


API Expectation 


APDU Expectation 


20 


InitDisplayTextO 

dcs = 4 

buffer = 00 01 ... OF 








Successful call (with tag 8Dh) 

f IndAndCopyValue () 
tag = 8Dh 
occurrence = 1 
valueOffset = 
dstBuffer .length = 17 
dstOffset = 
dstLength = 17 


Result of finclAndcopyValueO is 
17 




21 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




22 


Append tag OFh 

buffer = 00 01 ... OF 








Successful call (with tag 8Fh) 

f IndAndCopyValue () 
tag = 8Fh 
occurrence = 1 
valueOffset = 
dstBuffer . length =16 
dstOffset = 
dstLength =16 


Result of findAndcopyValueO is 
16 




23 


Compare buffer 

buffer = 00 01 ... OF 


Result is OOh 




24 


Invalid parameter 

f IndAndCopyValue {) 
occurrence = 


ToolkitException.BAD_INPUT_PA 
RAIVIETER is thrown 





5.2.4.15 Method findAndCompareValue(byte tag, byteQ compareBuffer, short 
compareOffset) 

Test Area Reference Api_2_Pah_Facrb_Bs. 



5.2.4.15.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

public byte f indAndCompareValue (byte tag, 

byte[] compareBuffer, 
short compareOffset) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
Toolkit Except ion 

5.2.4.15.1.1 Normal execution 

Looks for the first occurrence of a TLV element from beginning of a TLV list and compare its value with a buffer: 

CRRNl: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current 
TLV is no longer defined. 

CRRN2: if the method is successful then the corresponding TLV becomes current. 

CRRN3: if identical returns 0. 

CRRN4: if the first miscomparing byte in Comprehension TLV is less than that in compareBuffer returns -I. 

CRRN5: if the first miscomparing byte in Comprehension TLV is greater than that in compareBuffer returns 1. 

CRRN6: The search method is comprehension required flag independent. 
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5.2.4.15.1.2 Parameter errors 

• CRRPl: if compareBuffer is null NullPointerException shall be thrown. 

• CRRP2: if compareOffset would cause access outside array bounds ArraylndexOutOfBoundsException shall 
be thrown. 



5.2.4.15.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 



5.2.4.15.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.4.15.3 



Test area files 

Test_Api_2_Pah_Facrb_Bs.java. 
Api_2_Pah_Facrb_B s_ 1 .j ava. 
api_2_p ah_f acrb_b s . c ap . 

Test coverage 



CRR number 


Test case number 


N1 


6 


N2 


8 


N3 


7, 11, 12, 17 


N4 


9,13 


N5 


10, 14 


N6 


15, 16 


P1 


1 


P2 


2, 3, 4, 5 


01 


Does not apply for Proactive Handler 



5.2.4.15.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Initialize the handler 








findAndCompareValueO with a null dstBuffer 


NullPointerException is thrown 




2 


InitDisplayTextO with length = 15 








compareOffset > compareBuffer.length 

f indAndCompareValue () 
tag = ODh 

compareBuffer.length = 20 
compareOffset = 21 


Array 1 ndexOutOfBou ndsExceptio 
n is thrown 




3 


compareOffset < 

f IndAndCompareValue () 
compareBuffer.length = 20 
compareOffset = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


length > compareBuffer.length 

f indAndCompareValue () 
compareBuffer.length = 15 
compareOffset = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


compareOffset + length > 
compareBuffer.length 

f IndAndCompareValue () 
compareBuffer.length = 20 
compareOffset = 5 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


InitDisplayTextO 








Select a TLV (tag 02h) 








findAndCompareValueO 

tag = 03h 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown 






Call the getValueLengthO method 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown. 
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Id 


Description 


API Expectation 


APDU Expectation 


7 


InitDisplayTextO 

dcs = 4 

buffer = 00 01 ... OF 








Initialize compareBuffer 

compareBuffer = 
04 00 01 ... OF 








Compare buffers 

f IndAndCompareValue () 
tag = ODh 
compareOf f set = 


Result is OOh 




8 


Verify current TLV 

getValueLength ( ) 


Result is 17 




9 


Initialize compareBuffer 

compareBuffer = 
04 00 01 ... 10 








Compare buffers with same parameters 


Result is -1 




10 


Initialize compareBuffer 

compareBuffer = 
03 00 01 ... OF 








Compare buffers with same parameters 


Result is +1 




11 


Initialize compareBuffer 

compareBuffer = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 








Compare buffers 

f IndAndCompareValue () 
compareOf f set = 2 


Result is OOh 




12 


append a Text String TLV 

tag = ODh 

buffer = 00 11 22 33 44 55 








Initialize compareBuffer 

compareBuffer = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 








Compare buffers 

f IndAndCompareValue {) 
compareOf f set = 2 


Result is OOh 




13 


Initialize compareBuffer 

compareBuffer = 
55 55 04 01 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 








Compare buffers 

f IndAndCompareValue () 
compareOf f set = 2 


Result is -1 




14 


Initialize compareBuffer 

compareBuffer = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OD 10 55 








Compare buffers 

f IndAndCompareValue () 

compareOffset = 2 


Result is +1 




15 


InitDisplayTextO 

dcs = 4 

buffer = 00 01 ... OF 








Initialize compareBuffer 

CompareBuffer = 04 00 01 ... OF 








Successful call (withi tag 8Dh) 

f IndAndCompareValue () 
tag = 8Dh 

compareBuf fer . length = 17 
compareOffset = 


Result is OOh 
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Id 


Description 


API Expectation 


APDU Expectation 


16 


Append tag OFh 

buffer = 00 01 ... OF 








Initialize compareBuffer 

compareBuffer = 00 01 ... OF 








Successful call (with tag 8Fh) 

f IndAndCompareValue () 
tag = 8Fh 

compareBuffer . length =16 
compareOf f set = 


Result is OOh 




17 


Initialize compareBuffer 

compareBuffer = 00 99 01 03 ... OF 








Successful call (with tag BFh) 

f IndAndCompareValue () 
tag = 8Fh 

compareBuffer . length =16 
compareOf f set = 


Result is +1 





5.2.4.16 Method findAndCompareValue(byte tag, byte occurrence, short valueOffset, 
byteQ compareBuffer, short compareOffset, short compareLength) 

Test Area Reference Api_2_Pah_Facrbbs_Bss. 



5.2.4.16.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

public byte f IndAndCompareValue (byte tag, 

byte occurrence, 
short valueOffset, 
byte[] compareBuffer, 
short compareOffset, 
short compareLength) 
throws Java . lang.NullPointerException, 

Java . lang . ArraylndexOutOfBoundsException, 
Toolkit Except ion 



5.2.4.16.1.1 



Normal execution 



Looks for the indicated occurrence of a TLV element from the beginning of a TLV list and compare its value with a 
buffer: 

• CRRN 1 : if no TLV element is found, the UN AV AILABLE_ELEMENT exception is thrown and the current 
TLV is no longer defined. 

• CRRN2: if the method is successful then the corresponding TLV becomes current. 

• CRRN3: if identical is returned. 

• CRRN4: if the first miscomparing byte in Comprehension TLV is less than that in compareBuffer -1 is 
returned. 

• CRRN5: if the first miscomparing byte in Comprehension TLV is greater than that in compareBuffer 1 is 
returned. 

• CRRN6: The search method is comprehension required flag independent. 

5.2.4.16.1.2 Parameter errors 

• CRRPl: if compareBuffer is null NullPointerException shall be thrown. 

• CRRP2: if compareOffset or compareLength or both would cause access outside array bounds, or if 
compareLength is negative ArraylndexOutOfBoundsException shall be thrown. 
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• CRRP3: if valueOffset is negative or valueOffset + dstLength > current TLV length, an instance of 
ToolkitException shall be thrown. The reason code shall be 
ToolkitException.OUT_OF_TLV_BOUND ARIES. 

• CRRP4: if an input parameter is not valid (e.g. occurrence = 0) an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException.BAD_INPUT_PARAMETER. 



5.2.4.16.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AV AIL ABLE. 



5.2.4.16.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.4.16.3 



Test area files 

Test_Api_2_Pah_Facrbbs_Bss.java. 
Api_2_Pah_Facrbbs_Bss_l .Java. 
api_2_pah_facrbbs_bss.cap. 

Test coverage 



CRR number 


Test case number 


N1 


12 


N2 


14 


N3 


13, 17,20,21 


N4 


15, 18,22 


N5 


16,19 


N6 


23,24 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7,8,9, 10 


P4 


11 


01 


Does not apply for Proactive Handler 



5.2.4.16.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Initialize the handler 








findAndCompareValueO with a null 
compareBuffer 


NullPointerException is thrown 




2 


InitDisplayTextO with length = 15 








compareOffset > compareBuffer.length 

f IndAndCompareValue () 
tag = ODh, occurrence = 1 
valueOffset = 
compareBuffer.length = 5 
compareOffset = 6 
compareLength = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


compareOffset < 

f IndAndCompareValue () 
compareBuffer.length = 5 
compareOffset = -1 
compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


compareLength >compareBuffer.length 

f IndAndCompareValue () 
compareBuffer.length = 5 
compareOffset = 
compareLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


compareOffset + compareLength 
>compareBuffer.length 

f IndAndCompareValue () 
compareBuffer.length = 5 
compareOffset = 3 
compareLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


6 


compareLength < 

f IndAndCompareValue () 
compareBuff er . length = 5 
compareOf f set = 
compareLength = -1 


Array 1 ndexOutOfBou ndsExceptio 
n is thrown 




7 


InltDisplayTextQ with length = 5 








valueOffset > Text String Length 

f IndAndCompareValue () 
tag = ODh, occurrence = 1 
valueOffset = 7 
compareBuff er . length = 15 
compareOf f set = 
compareLength = 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

f IndAndCompareValue () 
valueOffset = -1 
compareBuff er . length = 15 
compareOf fset = 
compareLength = 1 


Tooll<itException.OUT OF TLV 
BOUNDARIES is thrown 




9 


compareLength > Text String length 

f IndAndCompareValue () 
valueOffset = 
compareBuff er . length = 15 
compareOf fset = 
compareLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


valueOffset + compareLength > Text String 
length 

f IndAndCompareValue () 
valueOffset = 2 
compareBuffer . length = 15 
compareOf fset = 
compareLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Invalid parameter 

f IndAndCompareValue {) 

occurrence = 


ToolkitException.BAD_INPUT_PA 
RAIVIETER is thrown 




12 


InltDisplayTextQ 








Select a TLV (tag 02h) 








findAndCompareValueQ 

tag = ODh 
occurrence = 2 


ToolkitException.UNAVAILABLE_ 
ELEMENT is thrown 






Call the getValueLengthO method 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown. 




13 


InitDisplayTextO 

dcs = 4 

buffer = 00 01 ... OF 








Initialize compareBuffer 

compareBuffer = 
04 00 01 ... OF 








findAndCompareValueQ 

tag = ODh, occurrence = 1 
valueOffset = 
compareOf fset = 
compareLength = 17 


Result is OOh 




14 


Verify current TLV 

getValueLength ( ) 


Result is 17 




15 


Initialize compareBuffer 

compareBuffer = 
04 00 01 ... 10 








Compare buffers with same parameters 


Result is -1 




16 


Initialize compareBuffer 

compareBuffer = 
03 00 01 ... OF 








Compare buffers with same parameters 


Result is +1 
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Id 


Description 


API Expectation 


APDU Expectation 


17 


Initialize compareBuffer 

compareBuff er = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 








Compare buffers 

f IndAndCompareValue () 
valueOffset = 2 
compareOf f set = 3 
compareLength = 12 


Result is OOh 




18 


Initialize compareBuffer 

compareBuffer = 
55 55 55 02 01 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 








Compare buffers with same parameters 


Result is -1 




19 


Initialize compareBuffer 

compareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OA OD 
55 55 55 55 55 








Compare buffers with same parameters 


Result is +1 




20 


append a Text String TLV 

tag = ODh 

buffer = 00 11 22 33 44 55 








Initialize compareBuffer 

compareBuffer = 
04 00 01 ... OF 








findAndCompareValueQ 

tag = ODh, occurrence = 1 
valueOffset = 
compareOf f set = 
compareLength = 17 


Result is OOh 




21 


Initialize compareBuffer 

compareBuffer = 
00 11 22 33 44 55 








findAndCompareValueQ 

tag = ODh, occurrence = 2 
valueOffset = 
compareOf f set = 
compareLength = 6 


Result is OOh 




22 


Initialize compareBuffer 

compareBuffer = 
00 11 22 33 44 66 








findAndCompareValueQ 

tag = ODh, occurrence = 2 
valueOffset = 
compareOf f set = 
compareLength = 6 


Result is -1 




23 


InitDisplayTextQ 

dcs = 4 

buffer = 00 01 ... OF 








Initialize compareBuffer 

CompareBuffer = 04 00 01 ... OF 








Successful call (with tag BDh) 

f IndAndCompareValue () 
tag = 8Dh, occurrence = 1 
valueOffset = 
compareBuff er . length = 17 
compareOf f set = 
compareLength = 17 


Result is OOh 




24 


Append tag OFh 

buffer = 00 01 ... OF 








Initialize compareBuffer 
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Id 


Description 


API Expectation 


APDU Expectation 




compareBuffer = 00 01 ... OF 








Successful call (with tag 8Fh) 

f IndAndCompareValue () 
tag = 8Fh, occurrence = 1 
valueOffset = 
compareBuf fer . length =16 
compareOf f set = 
compareLength =16 


Result is OOh 




25 


Initialize compareBuffer 

compareBuffer =0099 02 ... OF 








findAndCompareValueO 

f IndAndCompareValue () 
tag = ODh, occurrence = 1 
valueOffset = 
compareOf f set = 
compareLength = 17 


Result is +1 





5.2.4.17 Method appendArray 

Test Area Reference: Api_2_Pah_Apda. 



5.2.4.17.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

public void appendArray (byte [ ] buffer, 

short offset, 
short length) 
throws Java. lang.NullPointerException, 

Java . lang . Array I ndexOut Of Bounds Except ion, 
ToolkitException 

5.2.4.1 7.1 .1 Normal execution 

• CRRNl: appends a buffer into the Edithandler buffer. 

• CRRN2: a successful append does not modify the TLV selected. 

5.2.4.17.1.2 Parameter errors 

• CRRPl: if buffer is null, a java.lang.NullPointerException is thrown. 

• CRRP2: if offset or length or both would cause access outside the array bounds, or if length is negative, a 
java.lang.ArraylndexOutOfBoundsException is thrown. 



5.2.4.17.1.3 



Context errors 



CRRC 1 : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW. 

CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE. 



5.2.4.17.2 

Test Source: 
Test Applet: 
Cap File: 



Test area files 

Test_Api_2_Pah_Apda.j ava. 
Api_2_Pah_Apda_l .Java. 
api_2_pah_apda.cap. 
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5.2.4.17.3 



Test coverage 



CRR number 


Test case number 


N1 


9, 10, 11, 12 


N2 


8 


P1 


1 


P2 


2, 3, 4, 5, 6 


C1 


7 


C2 


Does not apply for ProactiveHandler 



5.2.4.17.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Null buffer 

appendArray () 


NullPointerException is thrown 




2 


Offset > buffer.length 

appendArray () 
buffer.length = 5 
offset = 6 
length = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


Offset < 

appendArray ( ) 
buffer.length = 5 

offset = -1 
length = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


length > buffer.length 

appendArray ( ) 
buffer.length = 5 
offset = 
length = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


offset + length > buffer.length 

appendArray () 
buffer.length = 5 
offset = 3 
length = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


length < 

appendArray () 
buffer.length = 5 
offset = 
length = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Handler overflow exception 

appendArray () 

buffer.length = getCapacity ( ) +1 

offset = 

length = getCapacity () +1 


Tooll<itException.HANDLER_OVE 
RFLOW is thrown 




8 


Initialize handler 








Select Command Details TLV 








Successful call 

appendArray ( ) 
buffer = FF FE ... F8 
offset = 
length = 8 








Verify Current TLV: Call getValueLength() 


Result is 03h 




9 


Clear the handler 








Successful call 

appendArray () 
buffer = FF FE ... F8 
offset = 
length = 8 








Call copyO method 








Compare the arrays 

compareBuf fer = FF FE ... F8 


Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 





ETSI 



Release 6 



237 



ETSI TS 102 268 V6.0.0 (2007-03) 



Id 


Description 


API Expectation 


APDU Expectation 


10 


Successful call 

appendArray ( ) 
buffer = 00 01 ... 07 
offset = 2 
length = 6 








Call copyO method 








Compare the arrays 

compareBuffer = FF FE ... F8 02 03 ... 07 


Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 




11 


Successful call 

appendArray () 
buffer = 11 22 ... 88 
offset = 2 
length = 4 








Call copvO method 








Compare the arrays 

compareBuffer = FF FE ... F8 02 03 ... 07 33 
44 55 66 


Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 




12 


Clear the handler 








Successful call 

appendArray () 
buffer = 00 01 ... FC 
offset = 
length = 253 








Call getLengthO method 


result = 253 






Call copyO method 








Compare handler 

compareBuffer = 00 01 ... FC 


Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 





5.2.4.1 8 Method appendTLV(byte tag, byte value) 

Test Area Reference: Api_2_Pah_Aptlbb. 

5.2.4.18.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public void appendTLV (byte tag, byte value) 
throws ToolkitException 

5.2.4.18.1.1 Normal execution 

• CRRNl: Appends a TLV element to the current TLV list (1-byte element). 

• CRRN2: A successful append does not modify the TLV selected. 



5.2.4.18.1.2 
No requirements. 

5.2.4.18.1.3 



Parameter errors 



Context errors 



• CRRC 1 : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW. 

• CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER NOT AVAILABLE. 
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5.2.4.18.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.4.18.3 



Test area files 

Test_Api_2_Pah_Aptlbb.java. 
Api_2_Pah_Aptlbb_ 1 .j ava. 
api_2_pah_aptlbb.cap. 

Test coverage 



CRR number 


Test case number 


N1 


3,4,5 


N2 


2 


C1 


1 


C2 


Does not apply for Proactive Handler 



5.2.4.18.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call appendArrayO 

length = getCapacity ( ) -1 








Handler Overflow exception: 
Call the appendTLVO method 


ToolkitException.HANDLER_OVE 
RFLOW is thrown 




2 


Initialize handler 








Select Command Details TLV 








Call the appendTLVO method 








Verify Current TLV: Call getValueLength() 


Result is 03h 




3 


Clear the handler 








Successful call 

appendTLV () 
tag = 84h 
value = OOh 








Call copyO method 








Compare the arrays 

compareBuf fer = 84 01 00 


Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 




4 


Successful call 

appendTLVO 
tag = Olh 
value = FEh 








Call copyO method 








Compare the arrays 

compareBuffer = 84 01 00 01 01 FE 


Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 




5 


Clear the handler 
Call appendArrayO 

length = 250 

buffer = 00 81 F7 03 04 ... F9 

Successful call 

appendTLV () 
tag = 84h 
value = OOh 

Call getLengthO method 
Call copyO method 
Compare the array 

compareBuffer = 00 81 F7 03 04 ... F9 84 01 
00 


result = 253 

Result of 

javacard.framework.Util.arrayConn 
pare() is OOh 
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5.2.4.1 9 Method appendTLV(byte tag, byte valuel , byte value2) 

Test Area Reference: Api_2_Pah_Aptlbbb. 

5.2.4.19.1 Conformance requirements 

The method with following header shall be compliant to its definition in the APT 

public void appendTLV (byte tag, 

byte valuel, 
byte value2) 
throws ToolkitException 

5.2.4.19.1.1 Normal execution 

• CRRNl: Appends a TLV element to the current TLV list (2-byte element). 

• CRRN2: A successful append does not modify the TLV selected. 



5.2.4.19.1.2 
No requirements. 



Parameter errors 



5.2.4.19.1.3 



Context errors 



• CRRC 1 : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW. 

• CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER NOT AVAILABLE. 



5.2.4.19.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.4.19.3 



Test area files 

Test_Api_2_Pah_Aptlbbb.java. 
Api_2_Pah_Aptlbbb_Ljava. 
api_2_p ah_ap tlbbb . c ap . 

Test coverage 



CRR number 


Test case number 


N1 


3,4,5 


N2 


2 


C1 


1 


C2 


Does not apply for Proactive Handler 



5.2.4.19.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call the appendArrayO 

length = getCapacity ( ) -1 








Handler Overflow exception: 
Call the appendTLVO method 


ToolkitException. HANDLER OVE 
RFLOW is thrown 




2 


Initialize handler 








Select Command Details TLV 








Call the appendTLVO method 








Verify Current TLV: Call getValueLength() 


Result is 03h 




3 


Clear the handler 








Successful call 

appendTLVO 
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tag = 84h 
valuel = OOh 
value2 = Olh 








Call copyO method 








Compare the arrays 

compareBuffer = 84 02 00 01 


Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 




4 


Successful call 

appendTLVO 
tag = Olh 
valuel = FEh 
value2 = FDh 








Call copvO method 








Compare the arrays 

compareBuffer = 84 02 00 01 01 02 FE FD 


Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 




5 


Clear the handler 








Call appendArrayO 

length = 249 

buffer = 00 81 F6 03 04 ... F8 








Successful call 

appendTLV () 
tag = 84h 
valuel = OOh 
value2 = Olh 








Call getLengthO method 


result = 253 






Call copyO method 








Compare handler 

compareBuffer = 00 81 F6 03 04 ... F8 84 02 
00 01 


Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 





5.2.4.20 Method appendTLV(byte tag, byte[ ] value, short valueoffset, short 
valuelength) 

Test Area Reference: Api_2_Pah_Aptlb_Bss. 

5.2.4.20.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void appendTLV (byte tag, 

byte [ ] value, 
short valueoffset, 
short valuelength) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
ToolkitException 

5.2.4.20.1.1 Normal execution 

• CRRNl: Appends a TLV element to the current TLV list (byte-array element). 

• CRRN2: A successful append does not modify the TLV selected. 

5.2.4.20.1 .2 Parameter errors 

• CRRPl: if value is null, a java.lang.NullPointerException is thrown. 

• CRRP2: if valueoffset or valuelength or both would cause access outside the array bounds, or if length is 
negative, a Java. lang. ArraylndexOutOfBoundsException is thrown. 
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5.2.4.20.1.3 



Context errors 



• CRRC 1 : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW. 

• CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE. 

• CRRC3: if valuelength is greater than 255, a ToolkitException is thrown with reason code 
BAD_INPUT_PARAMETER. 

5.2.4.20.2 Test area files 

Test Source: Test_Api_2_Pah_Aptlb_Bss.java. 
Test Applet: Api_2_Pah_Aptlb_Bss_l.java. 

Cap File: api_2_pah_aptlb_bss.cap. 



5.2.4.20.3 



Test coverage 



CRR number 


Test case number 


N1 


10, 11, 12, 13, 14 


N2 


9 


P1 


1 


P2 


2,3,4,5,6 


01 


7 


C2 


Does not apply for Proactive Handler 


C3 


8 



5.2.4.20.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Null value 

appenciTLVO 


NullPointerException is thrown 




2 


valueOffset > value.length 

appenciTLV () 
value . length = 5 
valueOffset = 6 
valueLength = 


Array 1 ndexOutOfBou ndsExceptio 
n is thrown 




3 


valueOffset < 

appendTLVO 
value . length = 5 
valueOffset = -1 
valueLength = 1 


Array 1 ndexOutOfBou ndsExceptio 
n is thrown 




4 


valueLength > value.length 

appendTLVO 
value.length = 5 
valueOffset = 
valueLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


valueOffset + valueLength > value.length 

appendTLVO 
value.length = 5 
valueOffset = 3 
valueLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


valueLength < 

appendTLVO 
value.length = 5 
valueOffset = 
valueLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Handler overflow exception 

Call the appendArray ( ) method, length = 

getCapacity () -1 

appendTLVO 

value.length = 254 

valueOffset = 

valueLength = 254 


Tooll<itException.HANDLER_OVE 
RFLOW is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


8 


Bad parameter exception 

Clear the handler 
appendTLV () 
value . length = 256 
valueOffset = 
valueLength = 256 


ToolkitException.BAD_INPUT_PA 
RAMETER is thrown 




9 


Initialize handler 








Select Command Details TLV 








Successful call 

appendTLV () 

tag = 04 

value = FF FE ... F8 

valueOffset = 

valueLength = 8 








Verify Current TLV: Call getValueLength() 


Result is 03h 




10 


Clear the handler 








Successful call 

appendTLVO 

tag = 04 

value = FF FE ... F8 

valueOffset = 

valueLength = 8 








Call copyO method 








Compare the arrays 

compareBuf fer = 04 08 FF FE ... F8 


Result of 

javacard.framework.Util.arrayCom 
pareO is OOh 




11 


Successful call 

appendTLVO 

tag = 85h 

value = 00 01 ... 07 

valueOffset = 2 

valueLength = 6 








Call copyO method 








Compare the arrays 

compareBuffer = 04 08 FF FE ... F8 85 06 02 
03 ... 07 


Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 




12 


Successful call 

appendTLV () 

tag = 01 

value = 11 22 ... 88 

valueOffset = 2 

valueLength = 4 








Call copyO method 








Compare the arrays 

compareBuffer = 04 08 FF FE ... F8 85 06 02 
03 ... 07 01 04 33 44 55 66 


Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 




13 


Clear the handler 








Successful call 

appendTLV () 

tag = 04 

value = 00 01 ... 7F 

valueOffset = 

valueLength = 80h 








Call copyO method 








Compare the arrays 

compareBuffer = 04 81 80 00 01. ..7F 


Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 
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Id 


Description 


API Expectation 


APDU Expectation 


14 


Clear the handler 

Successful call 

appendTLVO 

tag = 04 

value = 00 01 ... F9 

valueOffset = 

valueLength = 250 








Call getLengthO method 


result = 253 






Call copyO method 








Compare handler 


Result of 






compareBuf fer = 04 81 FA 00 01. ..F9 


javacard.framework.Util.arrayCom 
pare() is OOh 





5.2.4.21 Method appendTLV(byte tag, byte valuel , byte[ ] value2, short value2offset, 

short value2length) 

Test Area Reference: Api_2_Pah_Aptlbb_Bss. 



5.2.4.21.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

public void appendTLV (byte tag, 

byte valuel 
byte [ ] value2, 
short value2of f set , 
short value21ength) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
ToolkitException 

5.2.4.21 .1 .1 Normal execution 

• CRRNl: Appends a TLV element to the current TLV list (1 byte and a byte-array element). 

• CRRN2: A successful append does not modify the TLV selected. 

5.2.4.21.1.2 Parameter errors 

• CRRPl: if value2 is null, a Java. lang. NullPointerException is thrown. 

• CRRP2: if value2offset or value21ength or both would cause access outside the array bounds, or if length is 
negative, a Java. lang. ArraylndexOutOfBoundsException is thrown. 



5.2.4.21.1.3 



Context errors 



CRRC 1 : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW. 

CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE. 

CRRC3: if valuelength is greater than 255, a ToolkitException is thrown with reason code 
BAD INPUT PARAMETER. 
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5.2.4.21.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.4.21.3 



Test area files 

Te s t_ Api_2_Pah_Aptlbb_B s s .j a va . 
Api_2_Pah_Aptlbb_Bss_l .Java. 
api_2_pah_aptlbb_bss.cap. 

Test coverage 



CRR number 


Test case number 


N1 


10, 11, 12, 13, 14 


N2 


9 


P1 


1 


P2 


2, 3, 4, 5, 6 


C1 


7 


C2 


Does not apply for Proactive Handler 


C3 


8 



5.2.4.21.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Null value2 

appenciTLV () 


NullPointerException is thrown 




2 


value20ffset > value2.length 

appenciTLVO 
value2 . length = 5 
value20ffset = 6 
value2Length = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


value20ffset < 

appendTLVO 
value2 . length = 5 
value20ffset = -1 
value2Length = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


value2Length > value2.length 

appendTLVO 
value2 . length = 5 
value20ffset = 
value2Length = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


value20ffset + value2Length > value2.length 

appendTLV () 
value2 . length = 5 
value20ffset = 3 
value2Length = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


value2Length < 

appendTLV () 
value2 . length = 5 
value20ffset = 
value2Length = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Handler overflow exception 

Call the appendArray ( ) method, length = 

getCapacity () -1 

appendTLVO 

value2. length = 254 

value20ffset = 

value2Length = 254 


ToolkitException. HANDLER OVE 
RFLOW is thrown 




8 


Bad parameter exception 

Clear the handler 
appendTLV () 
value2. length = 256 
value20ffset = 
value2Length = 256 


ToolkitException. BAD_INPUT_PA 
RAIVIETER is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


9 


Initialize handler 








Select Command Details TLV 








Successful call 

appendTLV () 

tag = 04 

valuel = 05 

value2 = FF FE ... F8 

value20ffset = 

value2Length = 8 








Verify Current TLV: Call getValueLength() 


Result is 03h 




10 


Clear the handler 








Successful call 

appendTLVO 

tag = 04 

valuel = 05 

value2 = FF FE ... F8 

value20ffset = 

value2Length = 8 








Call copyO method 








Compare the arrays 

CompareBuffer = 04 09 05 FF FE ... F8 


Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 




11 


Successful call 

appendTLVO 
tag = 85h 
valuel = 55h 
value2 = 00 01 ... 07 
value20ffset = 2 
value2Length = 6 








Call copyO method 








Compare the arrays 

CompareBuffer = 

04 09 05 FF FE ... F8 

85 07 55 02 03 ... 07 


Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 




12 


Successful call 

appendTLV () 
tag = 01 
valuel = 44h 
value2 = 11 22 ... 88 
value20ffset = 2 
value2Length = 4 








Call copyO method 








Compare the arrays 

CompareBuffer = 
04 09 05 FF FE ... F8 
85 07 55 02 03 ... 07 
01 05 44 33 44 55 66 


Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 




13 


Clear the handler 








Successful call 

appendTLVO 
tag = 04 
valuel = 00 
value2 = 01 ... 7F 
value20ffset = 
value2Length = 7Fh 








Call copyO method 








Compare the arrays 

CompareBuffer = 04 81 80 00 01. ..7F 


Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 
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Id 


Description 


API Expectation 


APDU Expectation 


14 


Clear the handler 








Successful call 

appendTLVO 
tag = 04 
valuel = 00 
value2 = 01 ... F9 
value20ffset = 
value2Length = 249 








Call getLengthO method 


result = 253 






Call copyO method 








Compare handler 

compareBuffer = 04 81 FA 00 01. ..F9 


Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 





5.2.4.22 Method clear 

Test Area Reference: Api_2_Pah_Cler. 

5.2.4.22.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void clear () 

throws ToolkitException 

5.2.4.22.1.1 Normal execution 

• CRRN 1 : Clears the TLV list of an EditHandler. 

• CRRN2: Resets the current TLV selected. 



5.2.4.22.1.2 
No requirements. 

5.2.4.22.1.3 



Parameter errors 



Context errors 



CRRC 1 : if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE. 



5.2.4.22.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.4.22.3 



Test area files 

Test_Api_2_Pah_Cler.j ava. 

Api_2_Pah_Cler_l.java. 

api_2_pah_cler.cap. 

Test coverage 



CRR number 


Test case number 


N1 


1 


N2 


2 


CI 


Does not apply for Proactive Handler 
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5.2.4.22.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Initialize the handler 

Select Command Details TLV 
Call the getLengthQ method 


Result of getLengthQ is not null 






Clear the handler 

Call the getLengthQ method 


Result of getLengthQ is 




2 


Call the getValueLengthO method 


ToolkitException.UNAVAILABLE_ELEMENT 
is thrown 





5.2.4.23 Method getCapacity 

Test Area Reference: Api_2_Pah_Gcap. 

5.2.4.23.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte getCapacity ( ) 

5.2.4.23.1.1 Normal execution 

• CRRNl: The method shall return the maximum size of the Comprehension TLV list managed by the handler. 



5.2.4.23.1.2 
No requirements. 

5.2.4.23.1.3 
No requirements. 

5.2.4.23.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.4.23.3 



Parameter errors 
Context errors 
Test area files 

Test_Api_2_Pah_Gcap.java. 
Api_2_Pah_Gcap_ 1 .j ava. 
api_2_pah_gcap . cap . 

Test coverage 



CRR number 


Test case number 


N1 


1 
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5.2.4.23.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


ProactiveHandler available 

1- Send envelope Menu Selection 

2- The applet calls getTheHandler () 

3- The applet calls getCapacity () on the 
ProactiveHandler 

4- The applet fills the handler with the 
maximum capacity, using appendTLV ( ) method 

5- The applet calls clear () on the 
proactive handler 

6- The applet fills the handler with the 
maximum capacity plus one, using 
appendTLV method 


1- Applet is triggered 

2- No exception is thrown 

3- No exception is thrown, the 
capacity shall not be null 

4- No exception is thrown 

5- No exception Is thrown 

6- HANDLER_OVERFLOW 
exception is thrown 





5.2.4.24 Method initCloseChannel 

Test Area Reference: Api_2_Pah_Icch. 
5.2.4.24.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void initCloseChannel (byte bChannelldentif ier) 



5.2.4.24.1.1 



Normal execution 



5.2.4.24.1.2 
No requirements 

5.2.4.24.1.3 
No requirements 

5.2.4.24.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.4.24.3 



CRRNl: The method shall build a Close Channel Proactive command, using Channel Identifier. 
Comprehension Required flags are set. 

CRRN2: A call to this method clears the handler then initializes it with Close Channel Proactive command. 

CRRN3: After the method invocation, no TLV is selected. 

CRRN4: The Close Channel Proactive command is not sent by the method. 

Parameter errors 



Context errors 
Test area files 

Test_Api_2_Pah_Icch.j ava. 
Api_2_Pah_Icch_l .Java. 
api_2_pah_icch.cap. 

Test coverage 



CRR number 


Test case number 


N1 


1 


N2 


2 


N3 


3 


N4 


2,4 
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5.2.4.24.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Appletl is installed with maximum number 
of channel = 01. 






1 


Call initCloseChannelO method 

1- Call ProactiveHandler . init ( ) method to 
open a Channel. 

Call ProactiveHandler . send method. 

2- Send an 

EVENT_EVENT_DOWNLOAD_CHANNEL_STATUS 
Envelope . 

3- Call 

ProactiveHandler . initCloseChannel {) 
method with Channel Id = 01. 

4- Call ProactiveHandler . send method. 

5- Send an 

EVENT_EVENT_DOWNLOAD_CHANNEL_STATUS 
Envelope . 


2- Appletl is triggered. 
5- Appletl is not triggered. 


1- OPEN CHANNEL 
proactive command is 
fetched. 

TERMINAL RESPONSE of 
OPEN CHANNEL is sent to 
the UICC with Channel Id = 
01. 

4- CLOSE CHANNEL 
proactive command is 
fetched. 

TERMINAL RESPONSE of 
CLOSE CHANNEL is sent to 
the UICC. 


2 


Call the InitCloseChannel () method with any 

value then build and send a CLOSE CHANNEL 

command 

1- Call ProactiveHandler . init method to 
open a Channel and 
ProactiveHandler . send ( ) method. 

2- Call 

ProactiveHandler .InitCloseChannel () 
method with Channel Id = 2 

3- Call 

ProactiveHandler . InitCloseChannel () 
method with the Channel Id = 1 . 

4- Call sendO method. 

5- Send an 

EVENT_EVENT_DOWNLOAD_CHANNEL_STATUS 
Envelope . 


5- Appletl is not triggered. 


1- OPEN CHANNEL 
proactive command is 
fetched. 

TERMINAL RESPONSE of 
OPEN CHANNEL is sent to 
the UICC with Channel Id = 
01. 

4- CLOSE CHANNEL 
proactive command is 
fetched. 

TERMINAL RESPONSE of 
CLOSE CHANNEL is sent to 
the UICC. 


3 


Select a TLV in the ProactiveHandler 
Call the InitCloseChannel () method 

1- Call ProactiveHandler . init method to 
open a Channel and call the 
ProactiveHandler . send ( ) method. 

Select 1st TLV of the Proactive Handler. 

2- Call 

ProactiveHandler .InitCloseChannel () 
method with Channel Id = 01. 

3- Call ViewHandler.getValueLengthO 

method. 

4- Call ProactiveHandler . send ( ) method. 


3- UNAVAILABLE_ELEMENT 
ToolkitException is thrown by 
getValueLengthO method. 


1- OPEN CHANNEL 
proactive command is 
fetched. 

TERMINAL RESPONSE of 
OPEN CHANNEL is sent to 
the UICC with Channel Id = 
01. 

4- CLOSE CHANNEL 
proactive command is 
fetched. 

TERMINAL RESPONSE of 
CLOSE CHANNEL is sent to 
the UICC. 
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Id 


Description 


API Expectation 


APDU Expectation 


4 


Call the initCloseChannelO without sending 
the command 




1- OPEN CHANNEL 
proactive command is 




1- Call ProactiveHandler . init method to 


3- Appletl is triggered. 


fetched. 




open a Channel and call the 
ProactiveHandler . send ( ) method. 




TERMINAL RESPONSE of 
OPEN CHANNEL is sent to 




2- Call 




the UICC with Channel Id = 




ProactiveHandler .initCloseChannel () 




01. 




method with Channel Id = 01 without 








ProactiveHandler . send {) . 








3- Send an 

EVENT_EVENT_DOWNLOAD_CHANNEL_STATUS 
Envelope . 




No proactive command shall 
be sent. Expected status is 
'9000' 



5.2.4.25 Method getValueShort 

Test Area Reference: Api_2_Pah_Gvsh. 

5.2.4.25.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getValueShort (short valueOffset) 
throws ToolkitException 



5.2.4.25.1.1 



Normal execution 



• CRRNl: Gets a short from the last TLV element which has been found in the handler and returns its value 
(1 short). 



5.2.4.25.1.2 



Parameter errors 



CRRPl: if valueOffset is out of the current TLV an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException.OUT_OF_TLV_BOUND ARIES. 



5.2.4.25.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

• CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException.UNAVAILABLE_ELEMENT. 

5.2.4.25.2 Test area files 

Specific triggering: None 

Test Source: Test_Api_2_Pah_Gvsh.java. 
Test Applet: Api_2_Pah_Gvsh_l.java. 

Cap File: api_2_pah_gvsh.cap. 



5.2.4.25.3 



Test coverage 



CRR number 


Test case number 


N1 


3, 4, 5, 6, 7, 8 


PI 


2 


CI 


Does not apply for Proactive Handler 


C2 


1 
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5.2.4.25.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call the initO method 

type = FFh 
qualifier = FEh 
destination = FDh 








getValueShort(O) 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown 




2 


Search TLV 01 h (Command Details TLV) 








getValueShort(3) 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




3 


Search TLV 01 h (Command Details TLV) 








getValueShort(l) 


Result is FFh FEh (type, qualifier) 




4 


Search TLV 02h (Device Identities TLV) 








getValueShort(O) 


Result is 81 h FDh (Source, 
Destination) 




5 


InitDlsplayTextO 

buffer = 00 01 ... 7D 
length = 7Eh 

Search TLV ODh (Text String TLV) 








getValueShort(7D) 


Result is 7Ch 7Dh 




6 


InitDlsplayTextO 

buffer = 00 01 ... 7D 7E 
length = 7Fh 

Search TLV ODh (Text String TLV) 








getValueShort(7D) 


Result is 7Ch 7Dh 




7 


getValueShort(7E) 


Result is 7Dh 7Eh 




8 


InitDlsplayTextO 

buffer = 00 01 ... EF 
length = FOh 

Search TLV ODh (Text String TLV) 








getValueShort(EF) 


Result is EEh EFh 





5.2.4.26 Method appendTLV(byte tag, byte valuel , short value2) 

Test Area Reference: Api_2_Pah_Aptlbbs. 
5.2.4.26.1 Conformance requirements 

The method with following header shall be compliant to its definition in the API. 

public void appendTLV (byte tag, 

byte valuel, 
short value2) 
throws ToolkitException 

5.2.4.26.1.1 Normal execution 

• CRRNl: Appends a TLV element to the current TLV list (3-byte element(l -byte, 1 -short)). 

• CRRN2: A successful append does not modify the TLV selected. 

5.2.4.26.1 .2 Parameter errors 
No requirements. 
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5.2.4.26.1.3 



Context errors 



• CRRC 1 : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW. 

• CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE. 

5.2.4.26.2 Test area files 

Specific triggering: Unrecognized Envelope: 

Test Source: Test_Api_2_Pah_Aptlbbs.java. 
Test Applet: Api_2_Pah_Aptlbbs_l.java. 

Cap File: api_2_pah_aptlbbs.cap. 



5.2.4.26.3 



Test coverage 



CRR number 


Test case number 


N1 


3,4,5 


N2 


2 


C1 


1 


C2 


Does not apply for Proactive Handler 



5.2.4.26.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call the appendArrayO 

length = getCapacity () -1 








Handler Overflow exception: 
Call the appendTLVO method 


ToolkitException. HANDLER_OVE 
RFLOW is thrown 




2 


Initialize handler 








Select Command Details TLV 








Call the appendTLVO method 








Verify Current TLV: Call getValueLength() 


Result is 03h 




3 


Clear the handler 








Successful call 

appendTLV () 
tag = 84h 
valuel = OOh 
value2 = Olh 02h 








Call copyO method 








Compare the arrays 

compareBuf fer = 84 03 00 01 02 


Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 




4 


Successful call 

appendTLVO 
tag = Olh 
valuel = FEh 
value2 = FDh FCh 








Call copyO method 








Compare the arrays 

compareBuffer = 84 03 00 01 02 01 03 FE 
FD FC 


Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 
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Id 


Description 


API Expectation 


APDU Expectation 


5 


Clear the handler 








Call appendArrayO 

length = 248 

buffer = 00 81 F5 03 04 ... F7 








Successful call 

appendTLV () 
tag = 84h 
valuel = OOh 
value2 = Olh 02h 








Call getLengthO method 


result = 253 






Call copyO method 








Compare handler 

compareBuffer = 00 81 F5 03 04 ... F7 84 03 
00 01 02 


Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 





5.2.4.27 Method appendTLV(byte tag, short value) 

Test Area Reference: Api_2_Pah_Aptlbs. 

5.2.4.27.1 Conformance requirements 

The method with following header shall be compliant to its definition in the API. 

public void appendTLV (byte tag, 

short value) 
throws ToolkitException 

5.2.4.27.1.1 Normal execution 

• CRRNl: Appends a TLV element to the current TLV list (2-byte or 1-short element). 

• CRRN2: A successful append does not modify the TLV selected. 

5.2.4.27.1 .2 Parameter errors 
No requirements. 

5.2.4.27.1 .3 Context errors 

• CRRC 1 : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW. 

• CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE. 

5.2.4.27.2 Test area files 

Specific triggering: Unrecognized Envelope: 

Test Source: Test_Api_2_Pah_Aptlbs.java. 
Test Applet: Api_2_Pah_Aptlbs_l.java. 

Cap File: api_2_pah_aptlbs.cap. 
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5.2.4.27.3 



Test coverage 



CRR number 


Test case number 


N1 


3,4,5 


N2 


2 


C1 


1 


C2 


Does not apply for Proactive Handler 



5.2.4.27.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call appendArrayO 

length = getCapacity () -1 








Handler Overflow exception: 
Call the appendTLVO method 


ToolkitException.HANDLER_OVE 
RFLOW is thrown 




2 


Initialize handler 








Select Command Details TLV 








Call the appendTLVO method 








Verify Current TLV: Call getValueLength() 


Result is 03h 




3 


Clear the handler 








Successful call 

appendTLV () 
tag = 84h 
value = OOh Olh 








Call copyO method 








Compare the arrays 

compareBuf fer = 84 02 00 01 


Result of 

javacard.framework.Util.arrayCom 
pareO is OOh 




4 


Successful call 

appendTLV () 
tag = Olh 
value = FEh FFh 








Call copyO method 








Compare the arrays 

compareBuffer = 84 02 00 01 01 02 FE FF 


Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 




5 


Clear the handler 
Call appendArrayO 

length = 249 

buffer = 00 81 F6 03 04 ... F8 

Successful call 

appendTLVO 
tag = 84h 
value = OOh Olh 

Call getLengthO method 
Call copyO method 
Compare the array 

compareBuffer = 00 81 F6 03 04 ... F8 84 02 
00 01 


result = 253 

Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 
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5.2.4.28 Method appendTLV(byte tag, short valuel , short value2) 

Test Area Reference: Api_2_Pah_Aptlbss. 

5.2.4.28.1 Conformance requirements 

The method with following header shall be compliant to its definition in the API. 

public void appendTLV (byte tag, 

short valuel, 
short value2) 
throws ToolkitException 

5.2. 4.28.1 .1 Normal execution 

• CRRNl: Appends a TLV element to the current TLV list (4-byte element(2-short)). 

• CRRN2: A successful append does not modify the TLV selected. 



5.2.4.28.1.2 
No requirements. 



Parameter errors 



5.2.4.28.1.3 



Context errors 



• CRRC 1 : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW. 

• CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE. 

5.2.4.28.2 Test area files 

Specific triggering: Unrecognized Envelope: 

Test Source: Test_Api_2_Pah_Aptlbss.java. 
Test Applet: Api_2_Pah_Aptlbss_l.java. 

Cap File: api_2_pah_aptlbss.cap. 



5.2.4.28.3 



Test coverage 



CRR number 


Test case number 


N1 


3,4,5 


N2 


2 


C1 


1 


C2 


Does not apply for Proactive Handler 



5.2.4.28.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call the appendArrayO 

length = getCapacity () -1 








Handler Overflow exception: 
Call the appendTLVO method 


ToolkitException. HANDLER_OVE 
RFLOW is thrown 




2 


Initialize handler 








Select Command Details TLV 








Call the appendTLVO method 








Verify Current TLV: Call getValueLength() 


Result is 03h 
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Id 


Description 


API Expectation 


APDU Expectation 


3 


Clear the handler 








Successful call 

appendTLVO 
tag = 84h 
valuel = OOh Olh 
value2 = 02h 03h 








Call copyO method 








Compare the arrays 

compareBuffer = 84 04 00 01 02 03 


Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 




4 


Successful call 

appendTLV () 
tag = Olh 
valuel = FEh FDh 
value2 = FCh FBh 








Call copvO method 








Compare the arrays 

compareBuffer = 84 04 00 01 02 03 01 04 
FE FD FC FB 


Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 




5 


Clear the handler 








Call appendArrayO 

length = 247 

buffer = 00 81 F4 03 04 ... F6 








Successful call 

appendTLVO 
tag = 84h 
valuel = OOh Olh 
value2 = 02h 03h 








Call getLengthO method 


result = 253 






Call copyO method 








Compare handler 

compareBuffer = 00 81 F4 03 04 ... F6 84 04 
00 01 02 03 


Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 





5.2.4.29 Method appendTLV(byte tag, byte[] valuel , short valuel Offset, short 
valuel Length, byte[] value2, short value20ffset, short value2Length) 

Test Area Reference: Api_2_Pah_Aptlb_Bss_Bss. 



5.2.4.29.1 



Conformance requirements 



The method with following header shall be compliant to its definition in the API. 

public void appendTLV (byte tag, 

byte [ ] valuel, 
short valuelOf f set, 
short valuelLength, 
byte [ 1 value2, 
short value20f f set , 
short value2Length) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
ToolkitException 

5.2.4.29.1.1 Normal execution 

• CRRNl: Appends a TLV element to the current TLV list (2 byte arrays format). 

• CRRN2: A successful append does not modify the TLV selected. 
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5.2.4.29.1 .2 Parameter errors 

• CRRPl: If valuel or value2 is null, a NullPointerException is thrown. 

• CRRP2: If valuelOffset or valuelLength or both would cause access outside valuel array bounds, or if 
valuelLength is negative, an ArraylndexOutOfBoundsException is thrown. 

• CRRP3: If value20ffset or value 2Length or both would cause access outside value2 array bounds, or if 
value2Length is negative, an ArraylndexOutOfBoundsException is thrown. 



5.2.4.29.1.3 



Context errors 



CRRC 1 : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW. 

CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE. 

CRRC3: If valuelLength or value2Length is greater than 255, a ToolkitException is thrown with reason code 
BAD INPUT PARAMETER. 



5.2.4.29.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.4.29.3 



Test area files 

Te s t_ Api_2_Pah_ Aptlb_B ss_Bss.java. 
Api_2_Pah_Aptlb_Bss_Bss_l .Java. 
api_2_pah_aptlb_bss_bss.cap. 

Test coverage 



CRR number 


Test case number 


N1 


18, 19, 20,21 


N2 


16 


P1 


1,2 


P2 


3, 4, 5, 6, 7 


P3 


8,9, 10, 11, 12 


C1 


13 


C2 


Does not apply for ProactiveHandler 


C3 


14, 15 



5.2.4.29.4 



Test procedure 



id 


Description 


API Expectation 


APDU Expectation 


1 


Null valuel 

appendTLV () 


NullPointerException is thrown 




2 


Null value2 

appendTLV () 


NullPointerException is thrown 




3 


Valuel Offset > valuel .length 

appendTLVO 
valuel . length = 5 
valuelOffset = 5 
valuelLength = 1 
value2 . length = 5 
value20ffset = 
value2Length = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


4 


ValuelOffset <0 

appendTLV () 
valuel . length = 5 
valuelOffset = -1 
valuelLength = 1 
value2 . length = 5 
value20ffset = 
value2Length = 1 


Array 1 ndexOutOfBou ndsExceptio 
n is thrown 




5 


ValuelLength > valuel .length 

appendTLV () 
valuel . length = 5 
valuelOffset = 
valuelLength = 6 
value2 . length = 5 
value20ffset = 
value2Length = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


ValuelOffset + valuelLength > valuel .length 

appendTLVO 
Valuel . length = 5 
valuelOffset = 3 
valuelLength = 3 
value2 . length = 5 
value20ffset = 
value2Length = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Valuel Length <0 

appendTLVO 
valuel . length = 5 
valuelOffset = 
valuelLength = -1 
value2 . length = 5 
value20ffset = 
value2Length = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




8 


Value20ffset > value2.length 

appendTLVO 
valuel . length = 5 
valuelOffset = 
valuelLength = 1 
value2 . length = 5 
value20ffset = 5 
value2Length = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




9 


Value20ffset < 

appendTLVO 
valuel . length = 5 
valuelOffset = 
valuelLength = 1 
value2 . length = 5 
value20ffset = -1 
value2Length = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




10 


Value2Length > value2.length 

appendTLV () 
valuel . length = 5 
valuelOffset = 
valuelLength = 1 
value2 . length = 5 
value20ffset = 
value2Length = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




11 


Value20ffset + value2Length > value2.length 

appendTLV () 
valuel . length = 5 
valuelOffset = 
valuelLength = 1 
Value2. length = 5 
Value20ffset = 3 
Value2Length = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




12 


Value2Length < 

appendTLVO 
valuel . length = 5 
valuelOffset = 
valuelLength = 1 
value2 . length = 5 
value20ffset = 
value2Length = -1 


Array 1 ndexOutOfBou ndsExceptio 
n is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


13 


Handler overflow exception 

Call the appendArray ( ) method, length = 

getCapacity () -1 

appendTLV () 

Valuel. length = 256 

ValuelOffset = 

ValuelLength = 253 

Value2. length = 256 

Value20ffset = 

Value2Length = 1 


ToolkitException.HANDLER_OVE 
RFLOW is thrown 




14 


Bad parameter exception 

Clear the handler 
appendTLVO 
Valuel. length = 256 
ValuelOffset = 
ValuelLength = 256 
Value2 .length = 256 
Value20ffset = 
Value2Length = 1 


ToolkitException.BAD_INPUT_PA 
RAMETER is thrown 




15 


Bad parameter exception 

appendTLV () 
Valuel .length = 256 
ValuelOffset = 
ValuelLength = 1 
Value2. length = 256 
Value20ffset = 
Value2Length = 256 


Tooll<itException.BAD_INPUT_PA 
RAIVIETER is thrown 




16 


Successful call does not modify the current 
TLV 

1- clear the handler, append the handler 
with TLVs: 

81 03 11 22 33 

82 02 99 77 

2- Select Command Details TLV by using 
the findTLVO method 

3- Successful call of the AppendTLVO 
method 

tag = 04 

valuel = FF FE ... F8 
valuelOffset = 
ValuelLength = 8 
value2 = F7 F6 ... FO 
value20ffset = 
value2Length = 8 

Verify Current TLV: Call getValueLength() 
Clear the handler 








Result is 03h 




17 


Successful call 

appendTLV () 
tag = 04 

valuel = FF FE ... F8 
valuelOffset = 
ValuelLength = 8 
value2 = F7 F6 ... FO 
value20ffset = 
value2Length = 8 

Call copyO method 

Compare handler 

CompareBuffer = 04 10 FF FE ... FO 


Result is 00 




18 


Successful call 

appendTLV () 

tag = 85h 

valuel = 00 01 ... 07 

valuelOffset = 2 

ValuelLength = 6 

value2 = 08 09 ... OF 

value20ffset = 2 

value2Length = 6 

Call copyO method 

Compare handler 

CompareBuffer = 04 10 FF FE ... FO 85 OC 02 03 

04 05 06 07 OA OB OC OD OE OF 


Result is 00 
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Id 


Description 


API Expectation 


APDU Expectation 


19 


Successful call 

appendTLV () 
tag = 01 

valuel = 11 22 ... 88 
valuelOffset = 2 
valuelLength = 4 
value2 = 99 AA ... FF 00 
value20ffset = 2 
value2Length = 4 

Call copyO method 

Compare handler 

compareBuffer = 04 10 FF FE ... FO 85 OC 02 03 

04 05 06 07 OA OB OC OD OE OF 01 08 33 44 55 

66 BB CC DD EE 

Clear the handler 


Result is 00 




20 


Successful call 

appendTLV () 
tag = 04 

valuel = 00 01 ... 7F 
valuelOffset = 
valuelLength = 80h 
value2 = 80 81 ... FB 
value20ffset = 
value2Length = 7Ch 

Call copyO method 

Compare handler 

compareBuffer = 04 81 FC 00 01 ...FB 


Result is 00 





5.2.4.30 Method initMoreTime 

Test Area Reference: Api_2_Pah_Inmt. 

5.2.4.30.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void initMoreTime ( ) 

5.2.4.30.1.1 Normal execution 

• CRRNl: Builds a More Time Proactive command without sending the command. The Comprehension 
Required flags are all set to 1 . 

• CRRN2: After the method invocation no TLV is selected. 



5.2.4.30.1.2 
No requirements. 

5.2.4.30.1.3 
No requirements. 

5.2.4.30.2 

Test Source: 
Test Applet: 
Cap File: 



Parameter errors 
Context errors 
Test area files 

Test_Api_2_Pah_Inmt.j ava. 
Api_2_Pah_Inmt_ 1 .j ava. 
api_2_pah_inmt. cap . 
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5.2.4.30.3 



Test coverage 



CRR number 


Test case number 


N1 


1 


N2 


2 



5.2.4.30.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call initMoreTimeO method 

1- Call ProactiveHandler . InitMoreTime ( ) . 

2- Call ProactiveHandler . send ( ) method. 




1- MORE TIME proactive 
command is fetched. 

TERMINAL RESPONSE of 
MORE TIME is sent to the 
UICC. 


2 


Select a TLV in the ProactiveHandler 
Call the InitMoreTimeO method 

1- Select 1st TLV of the Proactive 
Handler . 

2- Call ProactiveHandler . InitMoreTime ( ) . 

3- Call ViewHandler.getValueLengthO 
method. 


3- UNAVAILABLE_ELEMENT 
ToolkitException is thrown by 
getValueLengthQ method. 





5.2.5 Interface ProactiveResponseHandler 
5.2.5.1 Method copyAdditionallnformation 

Test Area Reference: Api_2_Prh_Cpai. 

5.2.5.1.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short copyAdditionallnformation (byte [ ] dstBuffer^ 

short dstOffset, 
short dstLength) 
throws Java . lang . NullPointerException, 

Java .lang . Array I ndexOut Of Bounds Except ion, 
ToolkitException 



5.2.5.1.1.1 



Normal execution 



CRRNl: The copyAdditionalInformation() method shall copy a part of the additional information field from 
Result TLV element in dstBuffer, using dstOffset and dstLength. 

CRRN2: dstBuffer shall only be modified from dstOffset to (dstOffset + dstLength - 1) (included). 

CRRN3: The method returns (dstOffset + dstLength). 

CRRN4: If a Result TLV element is available, it becomes the TLV selected after a call to the method. 

CRRN5: The method shall copy from the first Result TLV. 
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5.2.5.1.1.2 Parameter errors 

• CRRP 1 : A NuUPointerException shall be thrown if dstBuffer is null. 

• CRRP2: An ArraylndexOutOfBoundsException shall be thrown if dstOffset or dstLength or both would cause 
access outside array bounds. 



5.2.5.1.1.3 



Context errors 



• CRRC 1 : A ToolkitException.UNAVAILABLE_ELEMENT shall be thrown in case of unavailable Result 
TLV element. 

• CRRC2: A ToolkitException.OUT_OF_TLV_BOUND ARIES shall be thrown if dstLength is greater than the 
value field of the available TLV. 



5.2.5.1.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.5.1.3 



Test area files 

Te s t_ Api_2_Prh_Cp ai .j a va . 
Api_2_Prh_Cpai_l .Java, 
ap i_2_prh_cp ai . c ap . 

Test coverage 



CRR number 


Test case number 


N1 


8, 11, 13, 15, 17,20,22 


N2 


20 


N3 


7, 10, 12, 14, 16,21 


N4 


9, 18,23 


N5 


21, 22,23 


PI 


1 


P2 


2, 3, 4, 5, 6 


C1 


24 


02 


19 



5.2.5.1.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Build and send a DISPLAY TEXT command 

qualifier = 

dcs = 4 

buffer = "Text" 




DISPLAY TEXT Proactive 
command 




Terminal Response with 11 additional bytes 

Result TLV = 03 OC 01 01 23 45 67 89 AB 
CD EF 01 23 45 








NULL as parameter to dstBuffer 

copyAdditionallnf ormation () 
dstBuffer = NULL 


NuUPointerException is thrown 




2 


dstOffset > dstBuffer.length 

copyAdditionallnf ormation () 
dstBuffer.length = 10 
dstOffset = 11 
dstLength = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


dstOffset < 

copyAdditionallnf ormation () 
dstBuffer.length = 10 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


dstLength > dstBuffer.length 

copyAdditionallnf ormation () 
dstBuffer.length = 10 
dstOffset = 
dstLength = 11 


ArraylndexOutOfBoundsExceptio 
n is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


5 


dstOffset + dstLength > dstBuffer.length 

copyAdditionalInf ormation () 
dstBuffer.length = 10 
dstOffset = 6 
dstLength = 5 


Array 1 ndexOutOfBou ndsExceptio 
n is thrown 




6 


dstLength < 

copyAdditionalInf ormation () 
dstBuffer.length = 10 
dstOffset = 6 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with 5 additional bytes 

Result TLV = 03 06 01 01 23 45 67 89 








Successful call, dstBuffer is the whole buffer 

copyAdditionalInf ormation () 
dstBuffer.length = 5 
dstOffset = 
dstLength = 5 


result of 

copyAdditionallnformationO is 
05h. 




8 


Compare dstBuffer using arrayCompare() 
method 

src = {01, 23, 45, 67, 89} 
srcOffset = 00 
dest = dstBuffer 
destOffset = 
length = 5 


result of arrayCompareO is OOh. 




9 


Call the getValueLengthO method 


Result is 06h. 




10 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with 6 additional bytes 

Result TLV = 03 07 01 AB CD EF FE DC BA 








Successful call, dstBuffer is part of a buffer 

copyAdditionalInf ormation () 
dstBuffer.length = 7 
dstOffset = 2 
dstLength = 5 


result of 

copyAdditionallnformationO is 
07h. 




11 


Compare dstBuffer using arrayCompare() 
method 

src = {AB, CD, EF, FE, DC} 
srcOffset = 00 
dest = dstBuffer 
destOffset = 2 
length = 5 


result of arrayCompareO is OOh. 




12 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with 7 additional bytes 

Result TLV = 03 08 01 FE DC BA 98 76 54 
32 








Successful call, dstBuffer is part of a buffer 

CopyAdditionalInf ormation () 
dstBuffer.length = 7 
dstOffset = 
dstLength = 5 


result of 

copyAdditionallnformationO is 
05h. 




13 


Compare dstBuffer using arrayCompare() 
method 

src = {FE, DC, BA, 98, 76} 
srcOffset = 00 
dest = dstBuffer 
destOffset = 
length = 5 


result of arrayCompareO is OOh. 
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Id 


Description 


API Expectation 


APDU Expectation 


14 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with 8 additional bytes 

Result TLV = 03 09 01 00 11 22 33 44 55 
66 77 








Successful call, dstBuffer is the whole buffer 

copyAdditionalInf ormation () 
dstBuffer. length = 9 
dstOffset = 2 
dstLength = 5 


result of 

copyAdditionallnformationO is 
07h. 




15 


Compare dstBuffer using arrayCompare() 
method 

src = {00, 11, 22, 33, 44} 
srcOffset = 00 
dest = dstBuffer 
destOffset = 2 
length = 5 


result of arrayCompareO is OOh. 




16 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with F2h additional bytes 

Result TLV = 03 81 F3 01 00 01 02 03... 








Successful call 

copyAdditionalInf ormation () 
dstBuffer. length = F2h 
dstOffset = 
dstLength = F2h 


result of 

copyAdditionallnformationO is 
F2fi. 




17 


Compare dstBuffer using arrayCompareQ 

src = {00, 01, 02, 03, 04...} 
srcOffset = 00 
dest = dstBuffer 
destOffset = 
length = F2h 


result of arrayCompareO is OOh. 




18 


Call the getValueLengthO method 


Result is F3h. 




19 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with 5 additional bytes 

Result TLV = 03 06 01 00 11 22 33 44 








dstLength > data available 

copyAdditionalInf ormation () 
dstBuffer .length = 6 
dstOffset = 
dstLength = 6 


OUT_OF_TLV_BOUNDARIES 
ToolkitException is thrown 




20 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with 5 additional bytes 

Result TLV = 03 06 01 00 11 22 33 44 








Initialize dstBuffer 

dstBuffer = {OOh, Olh, 02h, 03h...} 








Call the copyAdditionallnformationQ method 

dstBuffer .length = 20 
dstOffset = 5 
dstLength = 5 








Compare dstBuffer using arrayCompareQ 
method 

src = { 

OOh, Olh, 02h, 03h, 04h, 
OOh, llh, 22h, 33h, 44h, 
OAh, OBh, OCh, ODh, OEh, 
OFh, lOh, llh, 12h, 13h} 
srcOffset = 
dest = dstBuffer 
destOffset = 
length = 20 


result of arrayCompareO is OOh 
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Id 


Description 


API Expectation 


APDU Expectation 


21 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with 2 Result TLV 
elements 

1st Result TLV = 03 06 01 01 23 45 67 89 
2nd Result TLV = 03 01 00 








Successful call to copyAdditionallnformationQ 
method 

dstBuffer. length = 5 
dstOffset = 
dstLength = 5 


result of 

copyAdditionallnformationO is 
05h. 




22 


Compare dstBuffer using arrayCompareQ 
method 

src = {01, 23, 45, 67, 89} 
srcOffset = 00 
dest = dstBuffer 
destOffset = 
length = 5 


result of arrayCompareO is OOh. 




23 


Call the getValueLengthO method 


Result is 06h. 




24 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response without Result 
Comprehension TLV 


ToolkitException.UNAVAILABLE_ 
ELEMENT is thrown by send() 






ProactiveResponseHandler, getTheHandler 
call copyAdditionallnformationQ 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown 





5.2.5.2 Method copyTextString 

Test Area Reference: Api_2_Prh_Cpts. 



5.2.5.2.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

public short copyTextString (byte [ ] dstBuffer, 

short dstOffset) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
ToolkitException 



5.2.5.2.1.1 



Normal execution 



• CRRNl: The copyTextStringO method copies the text string value from the first Text String TLV element, 
using dstBuffer and dstOffset. 

• CRRN2: If a Text String TLV element is available, it becomes the TLV selected. 

• CRRN3: The method returns (dstOffset + length of copied value). 

5.2.5.2.1 .2 Parameter errors 

• CRRPl : A NullPointerException shall be thrown if dstBuffer is null. 

• CRRP2: A ArraylndexOutOfBoundsException shall be thrown if dstOffset or dstOffset + (length of the 
TextString to be copied, without the Data Coding Scheme included), as specified for the returned value, would 
cause access outside array bounds. 
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5.2.5.2.1.3 



Context errors 



• CRRC 1 : A ToolkitException.UNAVAILABLE_ELEMENT shall be thrown in case of unavailable Text String 
TLV element. 



5.2.5.2.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.5.2.3 



Test area files 

Test_Api_2_Prh_Cpts.java. 

Api_2_Prh_Cpts_l.java. 

api_2_prh_cpts.cap. 

Test coverage 



CRR number 


Test case number 


N1 


6, 8, 10, 13, 16, 18, 20 


N2 


11, 14,21 


N3 


5,7,9, 12, 15, 17, 19 


P1 


1 


P2 


2,3 


C1 


4 



5.2.5.2.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Build and send a GET INPUT command 

qualifier = OOh 
dcs = 04h 
buffer = 'Text' 
minRespLength = OOh 
maxRespLength = FFh 




GET INPUT Proactive 
command 




Terminal Response 

Text String TLV = OD 02 04 41 








ProactiveResponseHandler.getTheHandlerO ; 

call the copyTextStringO method with a null 
dstBuffer 

dstBuffer = null 
dstOffset = 


NullPointerException is thrown 




2 


Build and send a GET INPUT command 




GET INPUT Proactive 

command 

Proactive 




Terminal Response 

Text String TLV = OD 04 04 "ABC" 








dstOffset + text length > dstBuffer.length 

copyTextStrlng ( ) 
dstBuffer.length = 04h 
dstOffset = 02h 


ArraylndexOutOfBoundsException 
is thrown 




3 


dstOffset < 

copyTextStrlng () 
dstBuffer.length = 04h 
dstOffset = -1 


ArraylndexOutOfBoundsException 
is thrown 




4 


Build and send a DISPLAY TEXT command 

qualifier = OOh 
dcs = 04h 
buffer = 'Text' 




DISPLAY TEXT 
Proactive command 




Terminal Response without Text String TLV 








ProactiveResponseHandler.getTheHandlerO ; 

call the CopyTextStringO method 


UNAVAILABLE_ELEMENT 
ToolkitException is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


5 


Build and send a GET INPUT command 




GET INPUT Proactive 

command 

Proactive 




Terminal Response with a null Text String tlv 

Text String TLV = OD 00 








Initialize dstBuffer 

dstBuffer = {FOOh, FOlh, F02h, F03h} 








Call the copyTextStrlngO method 

dstBuffer. length = 04h 
dstOffset = 02h 


Result of copyTextStrlngO is 02h 




6 


Compare dstBuffer using arrayCompare() 

src = {OFOh, OFlh, 0F2h, 0F3h} 
srcOffset = OOh 
dest = dstBuffer 
destOffset = OOh 
length = 04h 


Result of arrayCompareO is OOh 




7 


Build and send a GET INPUT command 




GET INPUT Proactive 

command 

Proactive 




Terminal Response with text length = 01h 

Text String TLV = OD 02 04 41 








Initialize dstBuffer 

dstBuffer = {OOh, Olh, 02h, 03h} 








Call the copyTextStrlngO method 

dstBuffer .length = 04h 
dstOffset = OOh 


Result of copyTextStrlngO Is 01 h 




8 


Compare dstBuffer using arrayCompare() 

src = {41h, Olh, 02h, 03h} 
srcOffset = OOh 
dest = dstBuffer 
destOffset = OOh 
length = 04h 


Result of arrayCompareO Is OOh 




9 


Build and send a GET INPUT command 




GET INPUT Proactive 

command 

Proactive 




Terminal Response with text length = 02h 

Text String TLV = OD 03 04 42 43 








Initialize dstBuffer 

dstBuffer = {OOh, Olh, 02h, 03h} 








Call the copyTextStrlngO method 

dstBuffer .length = 04h 
dstOffset = 02h 


Result of copyTextStrlngO is 04h 




10 


Compare dstBuffer using arrayCompare() 

src = {OOh, Olh, 42h, 43h} 
srcOffset = OOh 
dest = dstBuffer 
destOffset = OOh 
length = 04h 


Result of arrayCompareO is OOh 




11 


Call the getValueLengthO method 


Result is 03h 




12 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = 7Eh 

Text String TLV = OD 7F 04 01 02 ... 7E 








Initialize dstBuffer 

dstBuffer = {OOh, OOh ... OOh} 








Call the copyTextStrlngO method 

dstBuffer .length = 7Eh 
dstOffset = OOh 


Result of copyTextStrlngO is 7Eh 
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Id 


Description 


API Expectation 


APDU Expectation 


13 


Compare dstBuffer using arrayCompare() 

src = {Olh, ..., 7Eh} 
srcOffset = OOh 
dest = dstBuffer 
destOffset = OOh 
length = 7Eh 


Result of arrayCompareO is OOh 




14 


Call the getValueLengthO method 


Result is 7Fh 




15 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = 7Fh 

Text String TLV = OD 81 80 04 01 02 ...7F 








Initialize dstBuffer 

dstBuffer = {OOh, Olh ... FFh} 








Call the copyTextStringO method 

dstBuffer .length = FFh 
dstOffset = lOh 


Result of copyTextStringO is 8Fh 




16 


Compare dstBuffer using arrayCompare() 

src = {OOh, Olh,... OFh, 
Olh, ...7Fh, 8Fh, ... FFh} 
srcOffset = OOh 
dest = dstBuffer 
destOffset = OOh 
length = FFh 


Result of arrayCompareO is OOh 




17 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = EFh 

Text String TLV = OD 81 FO 04 01 02 ... EF 








Initialize dstBuffer 

dstBuffer = {OOh, OOh ... OOh} 








Call the copyTextStringO method 

dstBuffer .length = FFh 
dstOffset = OOh 


Result of copyTextStringO is EFh 




18 


Compare dstBuffer using arrayCompare() 

src = {Olh, ...EFh, OOh ... OOh } 
srcOffset = OOh 
dest = dstBuffer 
destOffset = OOh 
length = FFh 


Result of arrayCompareO is OOh 




19 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with two Text String TLV 

1st Text String TLV = OD 03 04 42 43 
2nd Text String TLV = OD 02 04 44 








Initialize dstBuffer 

dstBuffer = {OOh, Olh, 02h, 03h} 








Call the copyTextStringO method 

dstBuffer .length = 04h 
dstOffset = 02h 


Result of copyTextStringO is 04h 




20 


Compare dstBuffer using arrayCompare() 

src = {OOh, Olh, 42h, 43h} 
srcOffset = OOh 
dest = dstBuffer 
destOffset = OOh 
length = 04h 


Result of arrayCompareO is OOh 




21 


Call the getValueLengthO method 


Result is 03h 





ETSI 



Release 6 



269 



ETSI TS 102 268 V6.0.0 (2007-03) 



5.2.5.3 Method getAdditionallnformationLength 

Test Area Reference: Api_2_Prh_Glil. 

5.2.5.3.1 Conformance requirement 

The method with following header shall be compliant to its definition in the APT 

public short getAdditionallnformationLength ( ) 

throws ToolkitException 



5.2.5.3.1.1 



Normal execution 



• CRRNl : This method returns the length of the additional information field from the first Result TLV in the 
ProactiveResponseHandler. 

• CRRN2: After a successful execution of the method, the Result TLV becomes the selected TLV of the 
ProactiveResponseHandler. 

5.2.5.3.1.2 Parameter errors 
No requirements. 

5.2.5.3.1.3 Context errors 

• CRRC 1 : A ToolkitException.UNAVAILABLE_ELEMENT shall be thrown in case of unavailable Result 
TLV element. 



5.2.5.3.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.5.3.3 



Test area files 

Test_Api_2_Prh_Gtil.java. 

Api_2_Prh_Gtil_l.java. 

api_2_prh_gtil.cap. 

Test coverage 



CRR number 


Test case number 


N1 


1, 3, 5,7,9, 11, 13 


N2 


2,4,6,8, 10, 12, 14 


C1 


15 



5.2.5.3.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Build and send a DISPLAY TEXT command 

qualifier = OOh 
dcs = 04h 
buffer = 'Text' 




DISPLAY TEXT Proactive 
command 




Terminal Response without additional 
information 








ProactiveResponseHandler.getTheHandlerO ; call 
the getAdditionallnformationLengthO method 


Result is OOh 




2 


Call the getValueLengthO method 


Result is 01 h 
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Id 


Description 


API Expectation 


APDU Expectation 


3 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT 

ProactiveProactive 

connnnand 




Terminal Response with 1 additional byte 

Result TLV = 03 02 02 55 








ProactiveResponseHandler.getTheHandlerQ ; 

call the getAdditionallnformationLengthO 

method 


Result is 01 h 




4 


Call the getValueLengthO method 


Result is 02h 




5 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT 

ProactiveProactive 

command 




Terminal Response with 7Eh additional bytes 

Result TLV = 03 7F 02 55 55 55 ... 








ProactiveResponseHandler.getTheHandlerQ ; 

call the getAdditionallnformationLengthO 

method 


Result is 7Eh 




6 


Call the getValueLengthO method 


Result is 7Fh 




7 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT 
Proactive command 




Terminal Response with 7Fh additional bytes 

Result TLV = 03 81 80 02 55 55 55 ... 








ProactiveResponseHandler.getTheHandlerQ ; 

call the getAdditionallnformationLengthO 

method 


Result is 7Fh 




8 


Call the getValueLengthO method 


Result is 80h 




9 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT 
Proactive command 




Terminal Response with 80h additional bytes 
Result TLV = 03 81 81 02 55 55 55 ... 








ProactiveResponseHandler.getTheHandlerO ; 

call the getAdditionallnformationLengthO 

method 


Result is 80h 




10 


Call the getValueLengthO method 


Result is 81 h 




11 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT 
Proactive command 




Terminal Response with F2h additional bytes 

Result TLV = 03 81 F3 02 55 55 55 ... 








ProactiveResponseHandler.getTheHandlerO ; 

call the getAdditionallnformationLengthO 

method 


Result is F2h 




12 


Call the getValueLengthO method 


Result is F3h 




13 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT 
Proactive command 




Terminal Response with 2 Result TLV 

1st Result TLV = 03 03 02 01 23 
2nd Result TLV = 03 01 00 








ProactiveResponseHandler.getTheHandlerO ; 

call the getAddltionallnformationLengthO 

method 


Result is 02h 




14 


Call the getValueLengthO method 


Result is 03h 




15 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT 
Proactive command 




Terminal Response without Result 
Comprehension TLV 


ToolkitException . UNAVAI LABLE_E 
LEMENT is thrown by send() 






Get ProactiveResponseHandler 








Call the getAdditionallnformationLengthO 


ToolkitException. UNAVAILABLE E 
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Id 


Description 


API Expectation 


APDU Expectation 




method 


LEMENT is thrown by 
getAdditionallnformationLength {) 





5.2.5.4 Method getGeneralResult 

Test Area Reference: Api_2_Prh_Gtgr. 

5.2.5.4.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte getGeneralResult ( ) 

throws ToolkitException 

5.2.5.4.1.1 Normal execution 

• CRRNl: This method returns the general result of a proactive command. 

• CRRN2: After a successful execution of the method, the Result TLV becomes the selected TLV of the 
ProactiveResponseHandler. 



5.2.5.4.1.2 

No requirements. 

5.2.5.4.1.3 



Parameter errors 



Context errors 



• CRRC 1 : A ToolkitException.UNAVAILABLE_ELEMENT shall be thrown in case of unavailable Result 
TLV element. 

• CRRC2: A ToolkitException.OUT_OF_TLV_BOUND ARIES shall be thrown if the general result byte is 
missing in the Result Comprehension TLV. 



5.2.5.4.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.5.4.3 



Test area files 

Test_Api_2_Prh_Gtgr.j ava. 
Api_2_Prh_Gtgr_l .Java. 
api_2_prh_gtgr. cap . 

Test coverage 



CRR number 


Test case number 


N1 


1,3, 5, 7, 9, 11 


N2 


2,4, 6,8, 10, 12 


C1 


13 


C2 


14 



ETSI 



Release 6 



272 



ETSI TS 102 268 V6.0.0 (2007-03) 



5.2.5.4.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Build and send a DISPLAY TEXT command 

qualifier = OOh 
dcs = 04h 
buffer = 'Text' 




DISPLAY TEXT Proactive 
command 




Terminal Response with General Result = 00 
(command performed successfully) 








ProactlveResponseHandler.getTheHandlerO 
Call the getGeneralResultO method 


Result of getGeneralResultO is OOh 




2 


Call the getValueLengthO method 


Result is 01 h 




3 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with General Result = 01, 

without Additional Information on result 

(command performed with partial 

comprehension) 








ProactlveResponseHandler.getTheHandlerO 
Call the getGeneralResultO method 


Result of getGeneralResultO is 01 h 




4 


Call the getValueLengthO method 


Result is 01 h 




5 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with General Result = 01, 
with Additional Information on result 

Result TLV = 03 02 01 55 (command 
performed with partial comprehension) 








ProactlveResponseHandler.getTheHandlerO 

Call the getGeneralResultO method 


Result of getGeneralResultO is 01 h 




6 


Call the getValueLengthO method 


Result is 02h 




7 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with General Result = 02 

Result TLV = 03 04 02 65 43 21 (Missing 
information) 








ProactlveResponseHandler.getTheHandlerO 

Call the getGeneralResultO method 


Result of getGeneralResultO is 02h 




8 


Call the getValueLengthO method 


Result is 04h 




9 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with 7Fh additional bytes 

Result TLV = 03 81 80 02 55 55 55 ... 








ProactlveResponseHandler.getTheHandlerO ; 
call the getGeneralResultO method 


Result is 02h 




10 


Call the getValueLengthO method 


Result is 80h 
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Id 


Description 


API Expectation 


APDU Expectation 


11 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with 2 Result TLV 

1st Result TLV = 03 02 02 12 
2nd Result TLV = 03 03 03 34 56 








ProactiveResponseHandler.getTheHandlerO ; 

call the getGeneralResult ( ) method 


Result is 02h 




12 


Call the getValueLengthO method 


Result is 02h 




13 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response without Result 
Comprehension TLV 








ProactiveResponseHandler.getTheHandlerQ ; 
call the getGeneralResultO method 


UNAVAILABLE_ELEMENT 
ToolkitException is thrown 




14 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response without General Result 
Byte in Result Comprehension TLV 








ProactiveResponseHandler.getTheHandlerO ; 
call the getGeneralResultO method 

Result TLV = 03 00 


OUT_OF_TLV_BOUNDARIES 
ToolkitException is thrown 





5.2.5.5 Method getltem Identifier 

Test Area Reference: Api_2_Prh_Gtii. 

5.2.5.5.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte getltemldentif ier ( ) 

throws ToolkitException 

5.2.5.5.1.1 Normal execution 

• CRRNl: The method returns the item identifier byte value from the first Item Identifier TLV element. 

• CRRN2: If an Item Identifier TLV element is available, it becomes the TLV selected. 



5.2.5.5.1.2 

No requirements. 

5.2.5.5.1.3 



Parameter errors 



Context errors 



• CRRC 1 : A ToolkitException.UNAVAILABLE_ELEMENT shall be thrown in case of unavailable Item 
Identifier TLV element. 

• CRRC2: A ToolkitException.OUT_OF_TLV_BOUND ARIES shall be thrown if the item identifier byte is 
missing in the Item Identifier Comprehension TLV. 
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5.2.5.5.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.5.5.3 



Test area files 

Test_Api_2_Prh_Gtii.java. 
Api_2_Prh_Gtii_l.java. 
api_2_prh_gtii. cap . 

Test coverage 



CRR number 



N1 



N2 



C1 



C2 



Test case number 



2, 4, 6, 8 



3, 5, 7, 9 



10 



5.2.5.5.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response (no Item Identifier TLV 
available) 








Call to getltemldentiflerO with unavailable Item 
Identifier TLV 


UNAVAILABLE_ELEMENT 
ToolkitException is thrown 




2 


Build and send a SELECT ITEM command with 
2items(ID=01,02) 




SELECT ITEM Proactive 
command 




Terminal Response with Item 1 selected 

Item Identifier TLV = 10 01 01 








Call the getltemldentiflerO method 


Result is 01 h 




3 


Call the getValueByteO method 

valueOffset = OOh 


Result is 01 h 




4 


Build and send a SELECT ITEM command with 
3 items (ID=03, 05, 07) 




SELECT ITEM Proactive 
command 




Terminal Response with Item 5 selected 

Item Identifier TLV = 10 01 05 








Call the getltemldentiflerO method 


Result is 05h 




5 


Call the getValueByteO method 

valueOffset = OOh 


Result is 05h 




6 


Build and send a SELECT ITEM command with 
3 items (ID=FDh, FEh, FFh) 




SELECT ITEM Proactive 
command 




Terminal Response with Item FFh selected 

Item Identifier TLV = 10 01 FF 








Call the getltemldentiflerO method 


Result is FFh 




7 


Call the getValueByteO method 

valueOffset = OOh 


Result is FFh 




8 


Build and send a SELECT ITEM command with 
3 items (ID=FDh, FEh, FFh) 




SELECT ITEM Proactive 
command 




Terminal Response with 2 Item Identifier tlv 

1st Item Identifier TLV = 10 01 FFh 
2nd Item Identifier TLV = 10 01 FEh 








Call the getltemldentiflerO method 


Result is FFh 




9 


Call the getValueByteO method 

valueOffset = OOh 


Result is FFh 




10 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
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Id 


Description 


API Expectation 


APDU Expectation 








command 




Terminal Response without item identifier in 
the Item Identifier Comprehension TLV 

Item Identifier TLV = 10 00 








Call to getltemldentifierO 


OUT_OF_TLV_BOUNDARIES 
ToolkitException is thrown 





5.2.5.6 Method getTextStringCodingScheme 

Test Area Reference: Api_2_Prh_Gtcs. 

5.2.5.6.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte getTextStringCodingScheme ( ) 

throws ToolkitException 

5.2.5.6.1.1 Normal execution 

• CRRNl: This method returns the data coding scheme from the first Text String TLV element. 

• CRRN2: If a Text String TLV element is available, it becomes the TLV selected. 



5.2.5.6.1.2 

No requirements. 

5.2.5.6.1.3 



Parameter errors 



Context errors 



• CRRC 1 : A ToolkitException.UNAVAILABLE_ELEMENT shall be thrown in case of unavailable Text String 
TLV element. 

• CRRC2: A ToolkitException.OUT_OF_TLV_BOUND ARIES shall be thrown if the Text String TLV is 
present with a length of 0. 



5.2.5.6.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.5.6.3 



Test area files 

Test_Api_2_Prh_Gtcs.java. 
Api_2_Prh_Gtc s_ Lj a va . 
api_2_prh_gtcs . cap . 

Test coverage 



CRR number 


Test case number 


N1 


3,5,7,9, 11, 13 


N2 


4,6,8, 10, 12, 14 


C1 


1 


C2 


2 
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5.2.5.6.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response (no Text String TLV 
element available) 








Call to getTextStringCodingSchemeO with 
unavailable Text String TLV 


UNAVAILABLE_ELEMENT 
ToolkitException is thrown 




2 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with a null Text String TLV 

Text String TLV = OD 00 








Call the getTextStringCodingSchemeO method 


OUT_OF_TLV_BOUNDARIES 
ToolkitException is thrown 




3 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = 01 h, 
DCS = 04h 

Text String TLV = OD 02 04 "A" 








Call the getTextStringCodingSchemeO method 


Result is 04h 




4 


Call the getValueLengthO method 


Result is 02h 




5 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = 02h, 
DCS = OOh 

Text String TLV = OD 03 00 "BB" 








Call the getTextStringCodingSchemeO method 


Result is OOh 




6 


Call the getValueLengthO method 


Result is 03h 




7 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = 7Eh, 
DCS = 08h 

Text String TLV = OD 7F 08 01 02 ... 7E 








Call the getTextStringCodingSchemeO method 


Result is 08h 




8 


Call the getValueLengthO method 


Result is 7Fh 




9 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = 7Fh, 
DCS = 04h 

Text String TLV = OD 81 80 04 01 02 ... 7F 








Call the getTextStringCodingSchemeO method 


Result is 04h 




10 


Call the getValueLengthO method 


Result is aOh 




11 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = EFh, 
DCS = 08h 

Text String TLV = OD 81 FO 08 01 02 ... EE 
EF 








Call the getTextStringCodingSchemeO method 


Result is 08h 




12 


Call the getValueLengthO method 


Result is FOh 




13 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with 2 Text String TLV 
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Id 


Description 


API Expectation 


APDU Expectation 




1st Text String TLV = OD 02 04 41 
2nd Text String TLV = OD 03 08 42 43 








Call the getTextStringCodingSchemeQ method 


Result is 04h 




14 


Call the getValueLengthO method 


Result is 02h 





5.2.5.7 Method GetTextString Length 

Test Area Reference: Api_2_Prh_Gttl. 

5.2.5.7.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getTextStringLength ( ) 

throws ToolkitException 



5.2.5.7.1.1 



Normal execution 



• CRRNl: The getTextStringLength() method returns the text string length value from the first Text String TLV 
element. 

• CRRN2: If a Text String TLV element is available, it becomes the TLV selected. 



5.2.5.7.1.2 

No requirements. 

5.2.5.7.1.3 



Parameter errors 



Context errors 



CRRCl: A ToolkitException. UN AVAILABLE_ELEMENT shall be thrown in case of unavailable Text String 
TLV element. 



5.2.5.7.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.5.7.3 



Test area files 

Test_Api_2_Prh_Gttl.java. 
Api_2_Prh_Gttl_l.java. 
api_2_prh_gttl. cap . 

Test coverage 



CRR number 



Test case number 



2,4,6,8, 10, 12, 14 



3,5.7,9, 11, 13, 15 



5.2.5.7.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response (no Text String TLV 
element available) 








Call to getTextStringLengthQ with unavailable 
Text String TLV 


UNAVAILABLE_ELEMENT 
ToolkitException is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


2 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with a null Text String TLV 

Text String TLV = OD 00 








Call the getTextStrlngLengthO method 


Result is OOh 




3 


Call the getValueLengthO method 


Result is OOh 




4 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = 01 h, 
DCS = 04h 

Text String TLV = OD 02 04 "A" 








Call the getTextStrlngLengthO method 


Result is 01 h 




5 


Call the getValueLengthO method 


Result is 02h 




6 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = 02h, 
DCS = OOh 

Text String TLV = OD 03 00 "BB" 








Call the getTextStrlngLengthO method 


Result is 02h 




7 


Call the getValueLengthO method 


Result is 03h 




8 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = 7Eh, 
DCS = 08h 

Text String TLV = OD 7F 08 01 02 ... 7E 








Call the getTextStrlngLengthO method 


Result is 7Eh 




9 


Call the getValueLengthO method 


Result is 7Fh 




10 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = 7Fh, 
DCS = 04h 

Text String TLV = OD 81 80 04 01 02 ... 7F 








Call the getTextStrlngLengthO method 


Result is 7Fh 




11 


Call the getValueLengthO method 


Result is aOh 




12 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = EFh, 
DCS = 04h 

Text String TLV = OD 81 FO 04 01 02 ... EE 
EF 








Call the getTextStrlngLengthO method 


Result is EFh 




13 


Call the getValueLengthO method 


Result is FOh 
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Id 


Description 


API Expectation 


APDU Expectation 


14 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with 2 Text String TLV 

1st Text String TLV = OD 02 04 41 
2nd Text String TLV = OD 03 08 42 43 








Call the getTextStringLengthO method 


Result is 01 h 




15 


Call the getValueLengthO method 


Result is 02h 





5.2.5.8 Method getLength 

Test Area Reference Api_2_Prh_Glen. 

5.2.5.8.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getLength () 

throws ToolkitException 

5.2.5.8.1.1 Normal execution 

• CRRNl : returns the length in bytes of the TLV list. 

5.2.5.8.1 .2 Parameter errors 
No requirements. 

5.2.5.8.1.3 Context errors 

• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 



5.2.5.8.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.5.8.3 



Test area files 

Test_Api_2_Prh_Glen.j ava. 
Api_2_Prh_Glen_ 1 .j ava. 
api_2_prh_glen.cap. 

Test coverage 



CRR number 


Test case number 


N1 


1,2 


CI 


Does not apply for Proactive Response Handler 
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5.2.5.8.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Build and send a Display Text command 




DISPLAY TEXT Proactive 
command 




Terminal Response without additional 
information in General Result TLV 








ProactiveResponseHandler.getTheHandlerO 

Call getLengthO method 


Result of getLengthO is 12 




2 


Build and send a Display Text command 




DISPLAY TEXT Proactive 
command 




Terminal Response with F2h additional 
information in General Result TLV 








ProactiveResponseHandler.getTheHandlerO 

Call getLengthO method 


Result of getLengthO is FFh 





5.2.5.9 Method copy 

Test Area Reference Api_2_Prh_Copy. 



5.2.5.9.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

public short copy (byte [] dstBuffer, 
short dstOffset, 
short dstLength) 
throws Java . lang . NullPointerException, 

Java .lang . Array IndexOutOfBoundsExcept ion, 
ToolkitException 

5.2.5.9.1.1 Normal execution 

• CRRNl: copies the Comprehension TLV list contained in the handler to the destination byte array. 

• CRRN2: returns dstOffset + dstLength. 

5.2.5.9.1 .2 Parameter errors 

• CRRP 1 : if dstBuffer is null a NullPointerException is thrown. 

• CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative, 
an ArraylndexOutOfBoundsException is thrown. 

• CRRP3: if dstLength is grater than the length of the Comprehension TLV List, an instance of 
ToolkitException shall be thrown. The reason code shall be 
ToolkitException.OUT_OF_TLV_BOUND ARIES. 



5.2.5.9.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 



5.2.5.9.2 

Test Source: 
Test Applet: 
Cap File: 



Test area files 

Test_Api_2_Prh_Copy.j ava. 
Api_2_Prh_Copy_ 1 .j ava. 
api_2_prh_copy .cap. 
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5.2.5.9.3 



Test coverage 



CRR number 


Test case number 


N1 


9, 11, 13 


N2 


8, 10, 12 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7 


C1 


Does not apply for Proactive Response Handler 



5.2.5.9.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response without Additional 
Information in General Result TLV: 

81 03 01 21 00 02 02 82 81 03 01 00 








ProactiveResponseHandler.getTheHandlerO 
copyO with NULL as parameter to dstBuffer 


NullPointerException is thrown 




2 


dstOffset > dstBuffer.length 

copy 

dstBuffer.length = 5 
dstOffset = 6 
dstLength = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


dstOffset < 

copy 

dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


dstLength > dstBuffer.length 

copy 

dstBuffer.length = 5 
dstOffset = 
dstLength = 6 


Array 1 ndexOutOfBou ndsExceptio 
n is thrown 




5 


dstOffset + dstLength > dstBuffer.length 

copy 

dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


dstLength < 

copy 

dstBuffer.length = 5 
dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


dstLength > length of the Comprehension TLV 
list 

copy 

dstBuffer.length = 13 
dstOffset = 
dstLength = 13 


Tooll<itException.OUT OF TLV 
BOUNDARIES is thrown 




8 


Successful call, dstBuffer is the whole buffer 

copy 

dstBuffer.length = 12 
dstOffset = 
dstLength = 12 


Result of copyO is 12 




9 


Compare the buffer with buffer: 

81 03 01 21 00 02 02 82 81 03 01 00 


Result of arrayCompareO is 




10 


Successful call, dstBuffer is part of a buffer 

copy 

dstBuffer.length = 20 
dstOffset = 3 
dstLength = 12 


Result of copyO is 15 
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Id 


Description 


API Expectation 


APDU Expectation 


11 


Compare the whole buffer 

Reference = 

00 01 02 

81 03 01 21 00 

02 02 82 81 

03 01 00 

OF 10 11 12 13 


Result of arrayCompareO is 




12 


Initialize dstBuffer 

dstBuffer = OOh Olh 02h ... 13h 








Successful call, dstBuffer is part of a buffer 

copy 

dstBuffer .length = 20 
dstOffset = 3 
dstLength = 9 


Result of copyO is 12 




13 


Compare the whole buffer 

Reference = 

00 01 02 

81 03 01 21 00 

02 02 82 81 

OC OD OE 

OF 10 11 12 13 


Result of arrayCompareO is 





5.2.5.10 Method findTLV 

Test Area Reference Api_2_Prh_Find. 

5.2.5.10.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte findTLV (byte tag, 

byte occurrence) 
throws ToolkitException 

5.2.5.10.1.1 Normal execution 

Looks for the indicated occurrence of a TLV element from the beginning of the TLV list (handler buffer): 

• CRRNl: the method is successful if the required occurrence exists then the corresponding TLV becomes 
current. 

• CRRN2: if the method is successful then it returns TLV_FOUND_CR_SET when Comprehension Required 
flag is set. 

• CRRN3: if the method is successful then it returns TLV_FOUND_CR_NOT_SET when Comprehension 
Required flag is not set. 

• CRRN4: if the required occurrence of the TLV element does not exist, the current TLV is no longer defined 
and TLV_NOT_FOUND is returned. 

• CRRN5: The search method is comprehension required flag independent. 

5.2.5.10.1.2 Parameter errors 

• CRRP 1 : if an input parameter is not valid (e.g. occurrence = 0) an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException.BAD_INPUT_PARAMETER. 



5.2.5.10.1.3 



Context errors 



CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 
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5.2.5.10.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.5.10.3 



Test area files 

Test_Api_2_Prh_Find.j ava. 

Api_2_Prh_Find_l.java. 

api_2_prh_find.cap. 

Test coverage 



CRR number 


Test case number 


N1 


3,5, 11, 13 


N2 


2,4 


N3 


10, 12 


N4 


6, 7,8, 9 


N5 


14,15 


P1 


1 


C1 


Does not apply for Proactive Response Handler 



5.2.5.10.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with 2 General Result TLV 

81 03 01 21 00 

82 02 82 81 
03 01 00 

03 02 01 12 








findTLVO with Invalid input parameter 

occurrence = 


ToolkitException.BAD_INPUT_PA 
RAMETER is thrown 




2 


Search 1st TLV 

findTLVO 
tag = Olh 
occurrence = 1 


Result is TLV_FOUND_CR_SET 




3 


Call the getValueLengthO method 


Result is 03h 




4 


Search 2nd TLV 

findTLVO 
tag = 02h 
occurrence = 1 


Result is TLV_FOUND_CR_SET 




5 


Call the getValueLengthO method 


Result is 02h 




6 


Select a TLV (tag 02h) 








Search a wrong tag 

findTLVO 
tag = 04h 
occurrence = 1 


Result is TLV_NOT_FOUND 




7 


Call the getValueLengthO method 


ToolkitException. UNAVAILABLE 
ELEMENT shall be thrown 




8 


Search a tag with wrong occurrence 

findTLVO 
tag = Olh 
occurrence = 2 


Result is TLV_NOT_FOUND 




9 


Call the getValueLengthO method 


ToolkitException. UNAVAILABLE 
ELEMENT shall be thrown. 




10 


Search 3rd TLV 

findTLVO 
tag = 03h 
occurrence = 1 


Result is 
TLV_FOUND_CR_NOT_SET 




11 


Call the getValueLengthO method 


Result is Olh 




12 


Search 3rd TLV 

findTLVO 
tag = 03h 
occurrence = 2 


Result is 
TLV_FOUND_CR_NOT_SET 




13 


Call the getValueLengthO method 


Result is 02h 
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Id 


Description 


API Expectation 


APDU Expectation 


14 


findTLVO 
Tag = 83h 
Occurrence = 


Search tag 83h 

1 


Result is 
TLV_FOUND_CR_NOT_SET 




15 


findTLVO 
Tag = 82h 
Occurrence = 


Search tag 82h 

1 


Result is TLV_FOUND_CR_SET 





5.2.5.11 Method getValueLength 

Test Area Reference Api_2_Prh_Gvle. 

5.2.5.1 1.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getValueLength ( ) 

throws ToolkitException 



5.2.5.11.1.1 



Normal execution 



CRRNl: gets and returns the binary length of the value field for the last TLV element which has been found in 
the handler. 



5.2.5.11.1.2 
No requirements. 

5.2.5.11.1.3 



Parameter errors 



Context errors 



CRRCl; if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException.UNAVAILABLE_ELEMENT. 



5.2.5.11.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.5.11.3 



Test area files 

Test_Api_2_Prh_Gvle.java. 
Api_2_Prh_Gvle_ 1 .j ava. 
api_2_prh_g vie . c ap . 

Test coverage 



CRR number 


Test case number 


N1 


2, 3, 4, 5, 6 


CI 


Does not apply for Proactive Response Handler 


C2 


1 
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5.2.5.11.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response 

Text String TLV = OD 00 








ProactiveResponseHandler.getTheHandlerO 

Call getValueLength method 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown 




2 


Search TLV ODh 








Call getValueLength ( ) method 


Result is OOh 




3 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response 

Text String TLV = OD 02 04 41 








Search TLV ODh (Text String TLV) 








Call getValueLength ( ) method 


Result is 02h 




4 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 7Eh 

Text String TLV = OD 7F 04 01 02 ... 7E 








Search TLV ODh (Text String TLV) 








Call getValueLength method 


Result is 7Fh 




5 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 7Fh 

Text String TLV = OD 81 80 04 01 02 ... 7E 
7F 








Search TLV ODh (Text String TLV) 








Call getValueLength method 


Result is 80h 




6 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = EFh 

Text String TLV = OD 81 FO 04 01 02 ... EF 








Search TLV ODh (Text String TLV) 








Call getValueLength ( ) method 


Result is FOh 





5.2.5.12 Method getValueByte 

Test Area Reference Api_2_Prh_Gvby. 

5.2.5.12.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte getValueByte (short valueOffset) 
throws ToolkitException 



5.2.5.12.1.1 



Normal execution 



CRRNl: Gets a byte from the last TLV element which has been found in the handler and returns its value (1 

byte). 



5.2.5.12.1.2 



Parameter errors 



CRRPl: if valueOffset is out of the current TLV an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException.OUT_OF_TLV_BOUND ARIES. 
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5.2.5.12.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

• CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException.UNAVAILABLE_ELEMENT. 



5.2.5.12.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.5.12.3 



Test area files 

Test_Api_2_Prh_Gvby.j ava. 
Api_2_Prh_Gvby_l .Java. 
api_2_prh_gvby . cap . 

Test coverage 



CRR number 


Test case number 


N1 


3, 4, 5, 6, 7, 8 


PI 


2 


CI 


Does not apply for Proactive Response Handler 


C2 


1 



5.2.5.12.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 7Eh 

Text String TLV = OD 7F 04 01 02 ... 7E 








ProactiveResponseHandler.getTheHandlerO 








Call getValueByte(O) method 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown 




2 


Search TLV 01 h (Command Details TLV) 








Call getValueByte (3) method 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




3 


Search TLV 01 h (Command Details TLV) 








Call getValueByte (2) method 


Result is OOh (qualifier) 




4 


Search TLV 02h (Device Identities TLV) 








Call getValueByte (0) method 


Result is 82h (Source) 




5 


Search TLV ODh (Text String TLV) 








Call getValueByte (7E) method 


Result is 7Eh 




6 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = EFh 

Text String TLV = OD 81 FO 04 01 02 ... 7E 
7F ... EF 








Search TLV ODh (Text String TLV) 








Call getValueByte (7E) method 


Result is 7Eh 




7 


Call getValueByte (7F) method 


Result is 7Fh 




8 


Call getValueByte (EF) method 


Result is EFh 
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5.2.5.13 Method copyValue 

Test Area Reference Api_2_Prh_Cpyvs_Bss. 

5.2.5.13.1 Conformance requirement 

The method with following header shall be compliant with its definition in the API. 

public short copyValue (short valueOffset, 

byte[] dstBuffer, 
short dstOffset, 
short dstLength) 
throws Java . lang . NullPointerException, 

Java .lang . Array I ndexOut Of Bounds Except ion, 
ToolkitException 

5.2.5.13.1.1 Normal execution 

• CRRNl: copies a part of the last TLV element which has been found, into a destination, buffer. 

• CRRN2: returns dstOffset + dstLength. 

5.2.5.13.1.2 Parameter errors 

• CRRP 1 : if dstBuffer is null NullPointerException is thrown. 

• CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative 
ArraylndexOutOfBoundsException is thrown. 

• CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException.OUT_OF_TLV_BOUND ARIES. 



5.2.5.13.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

• CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException.UNAVAILABLE_ELEMENT. 



5.2.5.13.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.5.13.3 



5.2.5.13.4 



Test area files 

Test_Api_2_Prh_Cpyv.j ava. 
Api_2_Prh_Cpy v_ Lj ava. 
api_2_prh_cpy V. cap . 

Test coverage 



CRR number 


Test case number 


N1 


13, 15 


N2 


12, 14 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7,8,9,10 


01 


Does not apply for Proactive Response Handler 


C2 


11 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send a GET INPUT command 




GET INPUT Proactive 
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Id 


Description 


API Expectation 


APDU Expectation 








command 




Terminal Response, Text String length = 5 

Text String TLV = OD 06 04 01 02 ... 05 








ProactiveResponseHandler.getTheHandlerO 

Select Text String TLV 








call copyValueQ method 
with a null dstBuffer 


NullPointerException is thrown 




2 


dstOffset > dstBuffer.length 

copyValue () 
dstBuffer.length = 5 
dstOffset = 6 
dstLength = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


dstOffset < 

copyValue () 
dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


dstLength >dstBuffer.length 

copyValue () 
dstBuffer.length = 5 
dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + dstLength >dstBuffer.length 

copyValue () 
dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


dstLength < 

copyValue ( ) 
dstBuffer.length = 5 
dstOffset = 

dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


valueOffset > Text String Length 

copyValue () 
valueOffset = 7 
dstBuffer.length = 15 
dstOffset = 
dstLength = 


Tooll<itException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

copyValue () 
valueOffset = -1 
dstBuffer.length = 15 
dstOffset = 
dstLength = 1 


Tooll<itException.OUT OF TLV 
BOUNDARIES is thrown 




9 


dstLength > Text String length 

copyValue () 
valueOffset = 
dstBuffer.length = 15 
dstOffset = 
dstLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


ValueOffset + dstLength > Text String length 

copyValue () 
ValueOffset = 2 
DstBuffer.length = 15 
DstOffset = 
DstLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 16 

Text String TLV = OD 11 04 00 01 ... OF 








ProactiveResponseHandler.getTheHandler 








call copyValueQ method 


ToolkitException.UNAVAILABLE_ 
ELEMENT is thrown 




12 


Select Text String TLV 








Successful call 

copyValue () 
ValueOffset = 
DstBuffer.length = 17 
DstOffset = 
DstLength = 17 


Result of copyValueO is 17 
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Id 


Description 


API Expectation 


APDU Expectation 


13 


Compare buffer 

Buffer = 04 00 01 ... OF 


Result is OOh 




14 


Initialize dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

copyValue () 
ValueOffset = 2 
DstBuffer. length = 20 
DstOffset = 3 
DstLength = 12 


Result of copyValueO is 15 




15 


Compare buffer 

Buffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 


Result is OOh 





5.2.5.14 Method compareValue 

Test Area Reference Api_2_Prh_Cprv. 



5.2.5.14.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

public byte compareValue (short valueOffset, 

byte[] compareBuf fer, 
short compareOf f set, 
short compareLength) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
ToolkitException 

5.2.5.14.1.1 Normal execution 
Compares the last found TLV element with a buffer: 

• CRRN 1 : returns if identical. 

• CRRN2: returns -1 if the first miscomparing byte in Comprehension TLV List is less than that in 
compareBuffer. 

• CRRN3: returns 1 if the first miscomparing byte in Comprehension TLV List is greater than that in 
compareBuffer. 

5.2.5.14.1.2 Parameter errors 

• CRRPl: if compareBuffer is null NullPointerException shall be thrown. 

• CRRP2: if compareOffset or compareLength or both would cause access outside array bounds, or if 
compareLength is negative ArraylndexOutOfBoundsException shall be thrown. 

• CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException.OUT_OF_TLV_BOUNDARIES. 



5.2.5.14.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

• CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException.UNAVAILABLE_ELEMENT. 
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5.2.5.14.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.5.14.3 



Test area files 

Test_Api_2_Prh_Cprv.j ava. 
Api_2_Prh_Cprv_ 1 .j ava. 
api_2_prh_cprv . c ap . 

Test coverage 



CRR number 


Test case number 


N1 


12, 15 


N2 


13, 16 


N3 


14, 17 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7,8,9, 10 


C1 


Does not apply for Proactive Response Handler 


C2 


11 



5.2.5.14.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 5 

Text String TLV = OD 06 04 01 02 ... 05 








ProactiveResponseHandler.getTheHandlerO 

Select Text String TLV 








compareValueQ with a null compareBuffer 


NullPointerException is thrown 




2 


compareOffset > compareBuffer.length 

compareValue () 
compareBuffer.length = 5 
compareOffset = 6 
compareLength = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


compareOffset < 

compareValue ( ) 
compareBuffer.length = 5 
compareOffset = -1 
compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


compareLength >compareBuffer.length 

compareValue ( ) 
compareBuffer.length = 5 
compareOffset = 
compareLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


compareOffset + compareLength 
>compareBuffer.length 

compareValue ( ) 
compareBuffer.length = 5 
compareOffset = 3 
compareLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


compareLength < 

compareValue ( ) 
compareBuffer.length = 5 
compareOffset = 
compareLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


valueOffset > Text String Length 

compareValue () 
valueOffset = 7 
compareBuffer.length = 15 
compareOffset = 
compareLength = 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


8 


valueOffset < 

compareValue ( ) 
valueOffset = -1 
compareBuff er . length = 15 
compareOf f set = 
compareLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


compareLength > Text String length 

compareValue ( ) 
valueOffset = 
compareBuff er . length = 15 
compareOf f set = 
compareLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is tlirown 




10 


valueOffset + compareLength > Text String 
length 

compareValue () 
valueOffset = 2 
compareBuffer . length = 15 
compareOf f set = 
compareLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is tlirown 




11 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 16 

Text String TLV = OD 11 04 00 01 ... OF 








ProactiveResponseHandler.getTheHandlerO 








call compareValue()method 


ToolkitException. UNAVAILABLE 
ELEMENT is tlirown 




12 


Select Text String TLV 








Initialize compareBuffer 

CompareBuffer = 
04 00 01 ... OF 








Compare buffers 

compareValue () 
ValueOffset = 
CompareOf f set = 
CompareLength = 17 


Result is OOh 




13 


Initialize compareBuffer 

CompareBuffer = 
04 00 01 ... 10 








Compare buffers with same parameters 


Result is -1 




14 


Initialize compareBuffer 

CompareBuffer = 
03 00 01 ... OF 








Compare buffers with same parameters 


Result is +1 




15 


Initialize compareBuffer 

CompareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 








Compare buffers 

compareValue () 
ValueOffset = 2 
CompareOf f set = 3 
CompareLength = 12 


Result is OOh 




16 


Initialize compareBuffer 

CompareBuffer = 
55 55 55 02 01 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 








Compare buffers with same parameters 


Result is -1 




17 


Initialize compareBuffer 

CompareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OA OD 
55 55 55 55 55 








Compare buffers with same parameters 


Result is +1 
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5.2.5.1 5 Method findAndCopyValue(byte tag, byteQ dstBuffer, short valueOffset) 

Test Area Reference Api_2_Prh_Facyb_Bs. 

5.2.5.15.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short f indAndCopyValue (byte tag, 

byte[] dstBuffer, 
short dstOffset) 
throws Java . lang.NullPointerException, 

Java . lang. ArraylndexOutOfBoundsException, 
Toolkit Except ion 



5.2.5.15.1.1 



Normal execution 



• CRRNl: looks for the first occurrence of a TLV element from the beginning of a TLV list and copy its value 
into a destination buffer. 

• CRRN2: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current 
TLV is no longer defined. 

• CRRN3: if the method is successful then the corresponding TLV becomes current and dstOffset + length of 
the copied value is returned. 

• CRRN4: The search method is comprehension required flag independent. 

5.2.5.15.1.2 Parameter errors 

• CRRP 1 : if dstBuffer is null NullPointerException shall be thrown. 

• CRRP2: if dstOffset would cause access outside array bounds ArraylndexOutOfBoundsException shall be 
thrown. 



5.2.5.15.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 



5.2.5.15.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.5.15.3 



Test area files 

Test_Api_2_Prh_Facyb_B s .j ava. 
Api_2_Prh_Facyb_Bs_l .Java. 
api_2_prh_facyb_bs.cap. 

Test coverage 



CRR number 


Test case number 


N1 


8, 10, 12 


N2 


6 


N3 


7, 9, 11 


N4 


13, 14 


P1 


1 


P2 


2, 3, 4, 5 


C1 


Does not apply for Proactive Response Handler 



5.2.5.15.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send a GET INPUT command 




GET INPUT Proactive 
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Id 


Description 


API Expectation 


APDU Expectation 








command 




Terminal Response, Text String length = 15 

Text String TLV = OD 10 04 01 02 ... OF 








ProactiveResponseHandler.getTheHandlerO 








call findAndCopyValueO method with a null 
dstBuffer 


NullPointerException is thrown 




2 


dstOffset > dstBuffer.length 

findAndCopyValue () 
tag = ODh 

dstBuffer.length = 20 
dstOffset = 21 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


dstOffset < 

findAndCopyValue () 
dstBuffer.length = 20 
dstOffset = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


length > dstBuffer.length 

findAndCopyValue () 
dstBuffer.length = 15 
dstOffset = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + length >dstBuffer.length 

findAndCopyValue () 
dstBuffer.length = 20 
dstOffset = 5 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 16 

Text String TLV = OD 11 04 00 01 ... OF 








ProactiveResponseHandler.getTheHandlerO 








Select a TLV (tag 02h) 








findAndCopyValueO 

tag = 04h 


Tooll<itException. UNAVAILABLE 
ELEMENT is thrown 






Call the getValueLengthO method 


Tooll<itException. UNAVAILABLE 
ELEIVIENT Is thrown. 




7 


Successful call 

findAndCopyValue () 
Tag = ODh 

DstBuffer.length = 17 
DstOffset = 


Result of findAndCopyValueO is 
17 




8 


Compare buffer 

Buffer = 04 00 01 ... OF 


Result is OOh 




9 


Initialize dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

findAndCopyValue () 
DstBuffer.length = 20 
DstOffset = 2 


Result of findAndCopyValueO is 
19 




10 


Compare buffer 

Buffer = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 


Result is OOh 




11 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, with 2 Text String TLV 

OD 11 04 00 01 ... OF 
OD 02 04 41 








ProactiveResponseHandler.getTheHandlerO 








Successful call 

findAndCopyValue () 
Tag = ODh 

DstBuffer.length = 17 
DstOffset = 


Result of findAndCopyValueO is 
17 




12 


Compare buffer 

Buffer = 04 00 01 ... OF 


Result is OOh 





ETSI 



Release 6 



294 



ETSI TS 102 268 V6.0.0 (2007-03) 



Id 


Description 


API Expectation 


APDU Expectation 


13 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 16 

Text String TLV = OD 11 04 00 01 ... OF 








ProactiveResponseHandler.getTheHandlerO 








Successful call (with tag 8Dh) 

f indAndCopyValue () 
Tag = 8Dh 

DstBuffer. length = 17 
DstOffset = 


Result of finclAndcopyValueO is 
17 




14 


Compare buffer 

Buffer = 04 00 01 ... OF 


Result is OOh 





5.2.5.1 6 Method findAndCopyValue(byte tag, byte occurrence, short valueOffset, 
byte[] dstBuffer, short dstOffset, short dstLength) 

Test Area Reference Api_2_Prh_Facybbs_Bss. 

5.2.5.16.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short f IndAndCopyValue (byte tag, 

byte occurrence, 
short valueOffset, 
byte[] dstBuffer, 
short dstOffset, 
short dstLength) 
throws Java . lang . NullPointerException, 

Java .lang . Array IndexOutOfBoundsExcept ion, 
ToolkitException 



5.2.5.16.1.1 



Normal execution 



• CRRNl: looks for the indicated occurrence of a TLV element from the beginning of a TLV list and copy its 
value into a destination buffer. 

• CRRN2: if no TLV element is found, the UN AV AILABLE_ELEMENT exception is thrown and the current 
TLV is no longer defined. 

• CRRN3: if the method is successful then the corresponding TLV becomes current and dstOffset + dstLength is 
returned. 

• CRRN4: The search method is comprehension required flag independent. 

5.2.5.16.1.2 Parameter errors 

• CRRPl: if dstBuffer is null NullPointerException shall be thrown. 

• CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative 
ArraylndexOutOfBoundsException shall be thrown. 

• CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException.OUT_OF_TLV_BOUNDARIES. 

• CRRP4: if an input parameter is not valid (e.g. occurrence = 0) an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException.BAD_INPUT_PARAMETER. 



5.2.5.16.1.3 



Context errors 



CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AV AIL ABLE. 
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5.2.5.16.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.5.16.3 



Test area files 

Te s t_ Api_2_Prh_Facybb s_B s s .j a va . 
Api_2_Prh_Facybbs_Bss_l .Java. 
api_2_prh_facybbs_bss.cap. 

Test coverage 



CRR number 


Test case number 


N1 


13, 15, 17, 19 


N2 


11 


N3 


12, 14, 16, 18 


N4 


20,21 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7,8,9, 10 


P4 


22 


C1 


Does not apply for Proactive Response Handler 



5.2.5.16.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 15 

Text String TLV = OD 10 04 01 02 ... OF 








ProactiveResponseHandler.getTheHandlerO 








findAndCopyValueO with a null dstBuffer 


NullPointerException is thrown 




2 


dstOffset > dstBuffer.length 

f IndAndCopyValue () 

tag = ODh, occurrence = 1 

valueOffset = 

dstBuffer.length = 5 

dstOffset = 6 

dstLength = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


dstOffset < 

f IndAndCopyValue () 
dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


dstLength > dstBuffer.length 

f IndAndCopyValue () 
dstBuffer.length = 5 
dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + dstLength > dstBuffer.length 

f indAndCopyValue () 
dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


dstLength < 

f IndAndCopyValue () 
dstBuffer.length = 5 
dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


7 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 5 

Text String TLV = OD 06 04 01 02 ... 05 








ProactiveResponseHandler.getTheHandlerO 








valueOffset > Text String Length 

f IndAndCopyValue () 

tag = ODh, occurrence = 1 

valueOffset = 7 

dstBuffer .length = 15 

dstOffset = 

dstLength = 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

f IndAndCopyValue () 
valueOffset = -1 
dstBuffer .length = 15 
dstOffset = 
dstLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


dstLength > Text String length 

f IndAndCopyValue {) 
valueOffset = 
dstBuffer .length = 15 
dstOffset = 
dstLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


valueOffset + dstLength > Text String length 

f IndAndCopyValue () 
valueOffset = 2 
dstBuffer .length = 15 
dstOffset = 
dstLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 16 

Text String TLV = OD 11 04 00 01 ... OF 








ProactiveResponseHandler.getTheHandlerO 








Select a TLV (tag 02h) 








findAndCopyValueO 

tag = ODh 
occurrence = 2 


ToolkitException.UNAVAILABLE_ 
ELEMENT is thrown 






Call the getValueLengthO method 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown. 




12 


Successful call 

f IndAndCopyValue () 

Tag = ODh, occurrence = 1 

ValueOffset = 

DstBuffer. length = 17 

DstOffset = 

DstLength = 17 


Result of findAndCopyValueQ is 
17 




13 


Compare buffer 

Buffer = 04 00 01 ... OF 


Result is OOh 




14 


Initialize dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

f IndAndCopyValue () 

Tag = ODh, occurrence = 1 

ValueOffset = 2 

DstBuffer .length = 20 

DstOffset = 3 

DstLength = 12 


Result of findAndcopyValueO is 
15 




15 


Compare buffer 

Buffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 


Result is OOh 
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Id 


Description 


API Expectation 


APDU Expectation 


16 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, with 2 Text String TLV 

OD 11 04 00 01 02 ... OF 

OD 06 00 11 22 33 44 55 (no specific DCS 

byte) 








ProactiveResponseHandler.getTheHandlerO 








Successful call 

f IndAndCopyValue {) 

Tag = ODh, occurrence = 1 

ValueOffset = 

DstBuffer. length = 17 

DstOffset = 

DstLength = 17 


Result of fincJAndCopyValueQ is 
17 




17 


Compare buffer 

Buffer = 04 00 01 ... OF 


Result is OOh 




18 


Successful call 

f IndAndCopyValue () 

Tag = ODh, occurrence = 2 

ValueOffset = 

DstBuffer .length = 6 

DstOffset = 

DstLength = 6 


Result of findAndCopyValueO is 6 




19 


Compare buffer 

Buffer = 00 11 22 33 44 55 


Result is OOh 




20 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 16 

Text String TLV = OD 11 04 00 01 ... OF 








ProactiveResponseHandler.getTheHandlerO 








Successful call (with tag BDh) 

f IndAndCopyValue () 

Tag = 8Dh, occurrence = 1 

ValueOffset = 

DstBuffer. length = 17 

DstOffset = 

DstLength = 17 


Result of findAndcopyValueO is 
17 




21 


Compare buffer 

Buffer = 04 00 01 ... OF 


Result is OOh 




22 


Invalid parameter 

f IndAndCopyValue () 
occurrence = 


ToolkitException.BAD_INPUT_PA 
RAIVIETER is thrown 





5.2.5.17 Method findAndCompareValue(byte tag, byte[] compareBuffer, short 
compareOffset) 

Test Area Reference Api_2_Prh_Facrb_Bs. 

5.2.5.17.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte f indAndCompareValue (byte tag, 

byte[] compareBuffer, 
short compareOffset) 
throws Java . lang. NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
ToolkitException 
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5.2.5.17.1.1 Normal execution 

Looks for the first occurrence of a TLV element from beginning of a TLV list and compare its value with a buffer: 

• CRRN 1 : if no TLV element is found, the UN AV AILABLE_ELEMENT exception is thrown and the current 
TLV is no longer defined. 

• CRRN2: if the method is successful then the corresponding TLV becomes current. 

• CRRN3: if identical returns 0. 

• CRRN4: if the first miscomparing byte in Comprehension TLV is less than that in compareBuffer returns -I. 

• CRRN5: if the first miscomparing byte in Comprehension TLV is greater than that in compareBuffer returns 1 . 

• CRRN6: The search method is comprehension required flag independent. 

5.2.5.17.1.2 Parameter errors 

• CRRPl: if compareBuffer is null NullPointerException shall be thrown. 

• CRRP2: if compareOffset would cause access outside array bounds ArraylndexOutOfBoundsException shall 
be thrown. 



5.2.5.17.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

5.2.5.17.2 Test area files 

Test Source: Test_Api_2_Prh_Facrb_Bs.java. 
Test Applet: Api_2_Prh_Facrb_Bs_Ljava. 

Cap File: api_2_prh_facrb_bs.cap. 

5.2.5. 1 7.3 Test coverage 



CRR number 


Test case number 


N1 


6 


N2 


8 


N3 


7, 11, 12 


N4 


9, 13 


N5 


10, 14 


N6 


15 


P1 


1 


P2 


2, 3, 4, 5 


C1 


Does not apply for Proactive Response Handler 
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5.2.5.17.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 15 

Text String TLV = OD 10 04 01 02 ... OF 








ProactiveResponseHandler.getTheHandlerO 








FindAndCompareValueO with a null dstBuffer 


NullPointerException is thrown 




2 


compareOffset > compareBuffer.length 

f IndAndCompareValue () 
tag = ODh 

compareBuffer.length = 20 
compareOffset = 21 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


compareOffset < 

f IndAndCompareValue () 
compareBuffer.length = 20 
compareOffset = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


length > compareBuffer.length 

f IndAndCompareValue () 
compareBuffer.length = 15 
compareOffset = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


CompareOffset + length > 
compareBuffer.length 

f IndAndCompareValue () 
CompareBuffer.length = 20 
CompareOffset = 5 


Array 1 ndexOutOfBou ndsExceptio 
n is thrown 




6 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 16 

Text String TLV = OD 11 04 00 01 ... OF 








ProactiveResponseHandler.getTheHandlerO 








Select a TLV (tag 02h) 








findAndCompareValueO 

tag = 04h 


Tooll<itException.UNAVAILABLE_ 
ELEMENT is thrown 






Call the getValueLengthO method 


Tooll<itException. UNAVAILABLE 
ELEIVIENT is thrown. 




7 


Initialize compareBuffer 

CompareBuf fer = 
04 00 01 ... OF 








Compare buffers 

f IndAndCompareValue () 
Tag = ODh 
CompareOffset = 


Result is OOh 




8 


Verify current TLV 

Call getValueLengthO method 


Result is 17 




9 


Initialize compareBuffer 

CompareBuffer = 
04 00 01 ... 10 








Compare buffers with same parameters 


Result is -1 




10 


Initialize compareBuffer 

CompareBuffer = 
03 00 01 ... OF 








Compare buffers with same parameters 


Result is +1 




11 


Initialize compareBuffer 

CompareBuffer = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 








Compare buffers 

f IndAndCompareValue () 
CompareOffset = 2 


Result is OOh 
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Id 


Description 


API Expectation 


APDU Expectation 


12 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, with 2 Text String TLV 

OD 11 04 00 01 ... OF 

OD 06 00 11 22 33 44 55 








ProactiveResponseHandler.getTheHandlerO 








Initialize compareBuffer 

CompareBuffer = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 








Compare buffers 

f indAndCompareValue () 
CompareOf f set = 2 


Result is OOh 




13 


Initialize compareBuffer 

CompareBuffer = 
55 55 04 01 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 








Compare buffers 

f IndAndCompareValue () 
CompareOf f set = 2 


Result is -1 




14 


Initialize compareBuffer 

CompareBuffer = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OD 10 55 








Compare buffers 

f indAndCompareValue () 
CompareOf f set = 2 


Result is +1 




15 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 16 

Text String TLV = OD 11 04 00 01 ... OF 








ProactiveResponseHandler.getTheHandlerO 








Initialize compareBuffer 

CompareBuffer = 
04 00 01 ... OF 








Compare buffers (with tag 8Dh) 

f indAndCompareValue () 
Tag = 8Dh 
CompareOf f set = 


Result is OOh 





5.2.5.18 Method findAndCompareValue(byte tag, byte occurrence, short valueOffset, 
byte[] compareBuffer, short compareOffset, short compareLength) 

Test Area Reference Api_2_Prh_Facrbbs_Bss. 



5.2.5.18.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 



public byte f indAndCompareValue (byte tag, 

byte occurrence. 



throws 



short valueOffset, 

byte[] compareBuffer, 

short compareOffset, 

short compareLength) 

Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 

ToolkitException 
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5.2.5.18.1.1 



Normal execution 



Looks for the indicated occurrence of a TLV element from the beginning of a TLV Hst and compare its value with a 
buffer: 

• CRRNl : if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current 
TLV is no longer defined. 

• CRRN2: if the method is successful then the corresponding TLV becomes current. 

• CRRN3: if identical is returned. 

• CRRN4: if the first miscomparing byte in Comprehension TLV is less than that in compareBuffer -1 is 
returned. 

• CRRN5: if the first miscomparing byte in Comprehension TLV is greater than that in compareBuffer 1 is 
returned. 

• CRRN6: The search method is comprehension required flag independent. 

5.2.5.18.1.2 Parameter errors 

• CRRPl: if compareBuffer is null NullPointerException shall be thrown. 

• CRRP2: if compareOffset or compareLength or both would cause access outside array bounds, or if 
compareLength is negative ArraylndexOutOfBoundsException shall be thrown. 

• CRRP3: if valueOffset, compareLength or both are out of the current TLV an instance of TooMtException 
shall be thrown. The reason code shall be ToolkitException.OUT_OF_TLV_BOUND ARIES. 

• CRRP4: if an input parameter is not valid (e.g. occurrence = 0) an instance of TooMtException shall be 
thrown. The reason code shall be ToolkitException.BAD_INPUT_PARAMETER. 



5.2.5.18.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

5.2.5.18.2 Test area files 

Test Source: Test_Api_2_Prh_Facrbbs_Bss.java. 
Test Applet: Api_2_Prh_Facrbbs_Bss_Ljava. 

Cap File: api_2_prh_facrbbs_bss.cap. 

5.2.5.18.3 Test coverage 



CRR number 


Test case number 


N1 


12 


N2 


14 


N3 


13, 17,20,21 


N4 


15, 18,22 


N5 


16,19 


N6 


23 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7,8,9, 10 


P4 


11 


C1 


Does not apply for Proactive Response Handler 
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5.2.5.18.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 15 

Text String TLV = OD 10 04 01 02 ... OF 
ProactiveResponseHandler . getTheHandler ( ) 








findAndCompareValueO with a null 
compareBuffer 


NullPointerException is thrown 




2 


compareOffset > compareBuffer.length 

f indAndCompareValue () 
tag = ODh, occurrence = 1 
valueOffset = 
compareBuffer.length = 5 
compareOffset = 6 
compareLength = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


compareOffset < 

f IndAndCompareValue () 
compareBuffer.length = 5 
compareOffset = -1 
compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


compareLength >compareBuffer.length 

f IndAndCompareValue () 
compareBuffer.length = 5 
compareOffset = 
compareLength = 6 


Array 1 ndexOutOfBou ndsExceptio 
n is thrown 




5 


CompareOffset + compareLength 
>compareBuffer.length 

f IndAndCompareValue () 
CompareBuffer.length = 5 
CompareOffset = 3 
CompareLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


compareLength < 

f indAndCompareValue () 
compareBuffer.length = 5 
compareOffset = 
compareLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 5 

Text String TLV = OD 06 04 01 02 ... 05 








ProactiveResponseHandler.getTheHandlerO 








valueOffset > Text String Length 

f IndAndCompareValue () 
tag = ODh, occurrence = 1 
valueOffset = 7 
compareBuffer.length = 15 
compareOffset = 
compareLength = 


Tooll<itException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

f indAndCompareValue () 
valueOffset = -1 
compareBuffer.length = 15 
compareOffset = 
compareLength = 1 


Tooll<itException.OUT OF TLV 
BOUNDARIES is thrown 




9 


compareLength > Text String length 

f IndAndCompareValue ( ) 
valueOffset = 
compareBuffer.length = 15 
compareOffset = 
compareLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


valueOffset + compareLength > Text String 
length 

f indAndCompareValue {) 
valueOffset = 2 
compareBuffer.length = 15 
compareOffset = 
compareLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


11 


Invalid parameter 

f IndAndCompareValue () 
Occurrence = 


ToolkitException.BAD_INPUT_PA 
RAMETER is thrown 




12 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 16 

Text String TLV = OD 11 04 00 01 ... OF 








ProactiveResponseHandler.getTheHandlerO 








Select a TLV (tag 02h) 








findAndCompareValueQ 

tag = ODh 
occurrence = 2 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown 






Call the getValueLengthO method 


Tooll<itException. UNAVAILABLE 
ELEIVIENT is thrown. 




13 


Initialize compareBuffer 

CompareBuffer = 
04 00 01 ... OF 








findAndCompareValueQ 

tag = ODh, occurrence = 1 
valueOffset = 
compareOf f set = 
compareLength = 17 


Result is OOh 




14 


Verify current TLV 

Call getValueLengthO method 


Result is 17 




15 


Initialize compareBuffer 

compareBuffer = 
04 00 01 ... 10 








Compare buffers with same parameters 


Result is -1 




16 


Initialize compareBuffer 

compareBuffer = 
03 00 01 ... OF 








Compare buffers with same parameters 


Result is +1 




17 


Initialize compareBuffer 

compareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 








Compare buffers 

f IndAndCompareValue () 
valueOffset = 2 
compareOf f set = 3 
compareLength = 12 


Result is OOh 




18 


Initialize compareBuffer 

compareBuffer = 
55 55 55 02 01 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 








Compare buffers with same parameters 


Result is -1 




19 


Initialize compareBuffer 

compareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OA OD 
55 55 55 55 55 








Compare buffers with same parameters 


Result is +1 
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Id 


Description 


API Expectation 


APDU Expectation 


20 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, with 2 Text String TLV 

OD 11 04 00 01 ... OF 

OD 06 00 11 22 33 44 55 








ProactiveResponseHandler.getTheHandlerO 








Initialize compareBuffer 

compareBuf f er = 
04 00 01 ... OF 








findAndCompareValueQ 

tag = ODh, occurrence = 1 
valueOffset = 
compareOf f set = 
compareLength = 17 


Result is OOh 




21 


Initialize compareBuffer 

compareBuffer = 
00 11 22 33 44 55 








findAndCompareValueQ 

tag = ODh, occurrence = 2 
valueOffset = 
compareOf f set = 
compareLength = 6 


Result is OOh 




22 


Initialize compareBuffer 

compareBuffer = 
00 11 22 33 44 66 








findAndCompareValueQ 

tag = ODh, occurrence = 2 
valueOffset = 
compareOf fset = 
compareLength = 6 


Result is -1 




23 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 16 

Text String TLV = OD 11 04 00 01 ... OF 








ProactiveResponseHandler.getTheHandlerQ 








Initialize compareBuffer 

CompareBuffer = 
04 00 01 ... OF 








Compare buffers (with tag 8Dh) 

f IndAndCompareValue () 
tag = 8Dh, occurrence = 1 
valueOffset = 
compareOf fset = 
compareLength = 17 


Result is OOh 





5.2.5.19 Method getCapacity 

Test Area Reference: Api_2_Prh_Gcap. 

5.2.5.19.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte getCapacity ( ) 

5.2.5.19.1.1 Normal execution 

• CRRNl : The method shall return the maximum size of the Comprehension TLV list managed by the handler. 

5.2.5.20.1.2 Parameter errors 
No requirements. 
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5.2.5.20.1.3 
No requirements. 

5.2.5.19.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.5.19.3 



Context errors 
Test area files 

Test_Api_2_Prh_Gcap.j ava. 

Api_2_Prh_Gcap_l.java. 

api_2_prh_gcap.cap. 

Test coverage 



CRR number 


Test case number 


N1 


1 



5.2.5.19.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


ProactiveResponseHandler available 

1- Send envelope Menu Selection 

2- The applet sends a proactive command 

3- Fetch the proactive command and send 
Terminal Response 

4- The applet calls getCapacity () method 

5- The applet calls getLengthO method 


1- Applet is triggered 

4-No exception is thrown 

5- The Capacity result is greater or 

equal to getLength{) result 


2- 91 XX 

3- The proactive command 
is fetched 



5.2.5.20 Method getChannelldentifier 

Test Area Reference: Api_2_Prh_Gcid. 

5.2.5.20.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte getChannelldentif ier ( ) 

throws ToolkitException 

5.2.5.201.1.1 Normal execution 

• CRRNl:The method shall return the channel identifier byte value. 

• CRRN2:The channel identifier byte value returned shall be from the first Channel status TLV element. 

• CRRN3: If the element is available it becomes the currently selected TLV. 

5.2.5.20.1 .2 Parameter errors 
No requirements. 

5.2.5.20.1 .3 Context errors 

• CRRC 1 : The method shall throw ToolkitException.UNAVAILABLE_ELEMENT if the Channel status TLV 
is not present. 

• CRRC2: The method shall throw ToolkitException.OUT_OF_TLV_BOUND ARIES if the Comprehension 
TLV Channel Status length is equal to 0. 
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5.2.5.20.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.5.21.3 



Test area files 

Test_Api_2_Prh_Gcid.j ava. 
Api_2_Prh_Gcid_l .Java. 
api_2_prh_gcid. cap . 

Test coverage 



CRR number 


Test case number 


N1 


3 


N2 


4 


N3 


5 


C1 


1 


C2 


2 
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5.2.5.20.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Appletl is installed with maximum number 
of channel = 01. 






1 


Channel status TLV is not present 

1- Build and send a DISPLAY TEXT command 

2- Call 

ProactiveResponseHandler .get Channel I dent if 
ier() method. 


2- UNAVAILABLE_ELEMENT 
ToolkitException is thrown 


1- DISPLAY TEXT 
Proactive command is 
fetched. 

TERMINAL RESPONSE 
with no Channel status TLV 
available. 


2 


Channel status TLV with a length equal to 

1- Build and send a OPEN CHANNEL proactive 
command 

2- Call 

ProactiveResponseHandler . getChannelldentif 
ier() method. 


2- OUT_OF_TLV_BOUNDARIES 
ToolkitException is thrown 


1- OPEN CHANNEL 
Proactive command is 
fetched. 

TERMINAL RESPONSE 
with Channel status TLV 
length equal to 0. 


3 


Get channel identifier value 

1- Call ProactiveHandler . init ( ) method to 
open a channel and ProactiveHandler . send () 

method. . 

2- Call 

ProactiveResponseHandler . getChannelldentif 
ier ( ) method. 

3- Call 

ProactiveHandler . initCloseChannel () and 
ProactiveHandler . send {) methods. 


2- Returns 0x01 


1- OPEN CHANNEL 
Proactive Command is 
fetched. 

TERMINAL RESPONSE is 
issued with channel status 
value = 0x81 00. 


4 


Get channel identifier value with 2 TLV 

1- Call ProactiveHandler . init ( ) method to 
open a channel and ProactiveHandler . send () 

method 

2- Call 

ProactiveResponseHandler .getChannelldentif 
ier 

3- Call 

ProactiveHandler . initCloseChannel () and 
ProactiveHandler . send ( ) methods. 


2- Returns 0x01 


1- OPEN CHANNEL 
Proactive Command is 
fetched. 

TERMINAL RESPONSE is 
issued with channel status 
value = 0x8100 and 0x8200. 


5 


Channel status TLV is currently selected TLV 

1- Call ProactiveHandler . init ( ) method to 
open a channel and ProactiveHandler . send () 
method. 

Call ViewHandler .FindTLVO method with 
Device Identity Tag. 

2- Call 

ProactiveResponseHandler .getChannelldentif 
ier ( ) method. 

3- Compare 

ProactiveResponseHandler .getChannelldentif 
ier() and ViewHandler .getValueByte (0) 
method results. 


2- Returns 0x03 

3- Check getChannelldentifierQ 
=getValueByte(0) 


1- OPEN CHANNEL 
Proactive Command is 
fetched. 

TERMINAL RESPONSE is 
issued with channel status 
value = 0x0305. 
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5.2.5.21 Method copyChannelData 

Test Area Reference: Api_2_Prh_Cchd. 

5.2.5.21.1 Conformance requirement 

The method with following header shall be compliant to its definition in the APT 

public short copyChannelData (byte [ ] dstBuffer, 

short dstOffset, 
short dstLength) 
throws Java . lang.NullPointerException, 

Java . lang . ArraylndexOutOfBoundsException, 
Toolkit Except ion 

5.2.5.21 .1 .1 Normal execution 

CRRNl: The method shall copy a part of the Channel data string field. 

CRRN2: The Channel data string field value returned shall be the first Channel data TLV element of the 
current response data field. 

CRRN3: If the element is available it becomes the currenly selected TLV. 

CRRN4: Returns dstOffset + dstLength. 



• 



• 



5.2.5.21.1.2 Parameter errors 

• CRRPl: If dstBuffer is null, a NuUPointerException is thrown. 

• CRRP2: If dstOffset or dstLength parameter is negative an ArraylndexOutOfBoundsException exception is 
thrown and no copy is performed. 

• CRRP3: If dstOffset+dstLength is greater than dstBuffer. length, the length of the dstBuffer array an 
ArraylndexOutOfBoundsException exception is thrown and no copy is performed. 

• CRRP4: If dstLength is greater than the value field of the available TLV, a OUT_OF_TLV_BOUND ARIES 
ToolkitException is thrown. 

5.2.5.21.1.3 Context errors 

• CRRC 1 : The method shall throw a UN AV AILABLE_ELEMENT ToolkitException if the Result TLV is not 
present. 

5.2.5.21.2 Test area files 

Test Source: Test_Api_2_Prh_Cchd.java. 
Test Applet: Api_2_Prh_Cchd_l.java. 

Cap File: api_2_prh_cchd.cap. 
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5.2.5.21.3 



Test coverage 



CRR number 


Test case number 


N1 


7, 10, 12, 14 


N2 


14 


N3 


9 


N4 


8, 11, 13, 15 


P1 


1 


P2 


2,3 


P3 


4 


P4 


5 


C1 


6 



5.2.5.21.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





1- Appletl is installed with maximum 
number of channel = 01 . 

2- Appletl builds proactive commands OPEN 
CHANNEL with initO method in order to 
open one channel . 

ProactiveHandler . send ( ) method is called. 




2- OPEN CHANNEL 
proactive command is 
fetched 

TERMINAL RESPONSE Is 
issued with Channel Id = 01 


1 


CopyChannelDataO with NULL dstBuffer 

Build and send a RECEIVE DATA command 

Call 

ProactiveResponseHandler . copyChannelData ( ) 

dstBuffer = NULL 

DstOffset = 

DstLength = 1 


NullPointerException is thrown 


RECEIVE DATA Proactive 
command is fetched. 

TERMINAL RESPONSE 
with not empty Channel 
Data TLV is issued. 


2 


CopyChannelDataO with negative dstOffset 

1- call initO method for the RECEIVE DATA 
proactive command. 

2- call 

ProactiveResponseHandler . copyChannelData ( ) 
DstBuffer .length = 6 

DstOffset = -1 
DstLength = 1 

3- check dstBuffer is empty. 


2- an 

ArraylndexOutOfBoundsException 
exception is tlirown. 

3- no copy is performed. 


1- RECEIVE DATA 
proactive command is 
fetched. 

TERMINAL RESPONSE 
with 6 bytes avalaible 
('Hellol') 


3 


CopyChannelDataO with negative dstLength 

1- call 

ProactiveResponseHandler . copyChannelData ( ) 
DstBuffer . length = 6 

DstOffset = 
DstLength = -1 

2- check dstBuffer is empty. 


1- an 

ArraylndexOutOfBoundsException 
exception is tlirown. 

2- no copy is performed. 




4 


CopyChannelDataO with dstOffset+dstLength 
greater than dstBuffer.length 

1- call 

ProactiveResponseHandler . copyChannelData ( ) 
with dstOffset+dstLength greater than 
dstBuffer . length . 

DstBuffer.length = 6 
DstOffset = 5 
DstLength = 2 

2- check dstBuffer is empty. 


1- an 

ArraylndexOutOfBoundsException 
exception Is thrown. 

2- no copy is performed. 
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Id 


Description 


API Expectation 


APDU Expectation 


5 


CopyChannelDataQ with dstLength too large 

Call 

ProactiveResponseHandler . copyChannelData ( ) 

with dstLength greater than the value 

field of the available TLV. 

DstBuffer. length = 10 

DstOffset = 

DstLength = 10 


an OUT_OF_TLV_BOUNDARIES 
ToolkitException is thrown. 




6 


CopyChannelDataO without Channel Data TLV 
element 

1- call initO method for the RECEIVE DATA 
proactive command. 

Call sendO method. 

2- call 

ProactiveResponseHandler . copyChannelData ( ) 
DstBuffer .length = 10 

DstOffset = 
DstLength = 10 


2- an UNAVAILABLE_ELEMENT 
ToolkitException is thrown. 


1- RECEIVE DATA 
proactive command is 
fetched 

TERMINAL RESPONSE 
without ChannelData TLV 
element. 


7 


Successful CopyChannelDataO 

Call initO method for the RECEIVE DATA 
proactive command. 
Call sendO method. 

2- Call findTLVO with TAG of DEVICE 

IDENTITY. 

3- Call 

ProactiveResponseHandler . copyChannelData ( ) 
DstBuffer . length = 6 

DstOffset = 
DstLength = 6 
DstBuffer is the whole Buffer. 


3- the Channel Data TLV is copied 
into dstBuffer. 

The applet checks the returned 
value is dstOffset + dstLength = 6. 


1- RECEIVE DATA 
proactive command is 
fetched 

TERMINAL RESPONSE 
with one Channel data TLV 
element. (6 bytes available 
= 'Hello2') 


8 


Compare copied Buffer 

Check dstBuffer. 


The applet checks that dstBuffer 
contains the channel data from the 
TERMINAL RESPONSE. 




9 


Check the Channel Data TLV is selected 

Call the ViewHandler .getValueByte (0) 

method 


The returned byte is the same than 
the first byte of the Channel data 
TLV (i.e. 'H') 




10 


Successful CopyChannelDataO 

Call 

ProactiveResponseHandler . copyChannelData ( ) 

DstBuffer . length = 6 

DstOffset = 2 

DstLength = 3 

DstBuffer is a part of Buffer. 


The Channel Data TLV is copied 
into dstBuffer. 

The applet checks the returned 
value is dstOffset + dstLength = 5. 




11 


Compare copied Buffer 

Check dstBuffer. 


The applet checks that bytes from 2 
to 4 of dstBuffer contain the first 3 
bytes of channel data TLV from the 
TERMINAL RESPONSE. 




12 


Successful CopyChannelDataO 

1- Initialize dstBuffer to [00, 01...] 

2- Call 

ProactiveResponseHandler . copyChannelData ( ) 
DstBuffer .length = 6 

DstOffset = 2 
DstLength = 3 

DstBuffer is a part of buffer. 


2- The Channel Data TLV is copied 
into dstBuffer. 

The returned value is dstOffset + 
dstLength = 5. 
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Id 


Description 


API Expectation 


APDU Expectation 


13 


Compare copied Buffer 

Check dstBuffer. 


The applet checks that only bytes 
from 2 to 4 of dstBuffer have been 
updated with the first 3 bytes of 
channel data TLV from the 
TERMINAL RESPONSE. 




14 


Successful copyChannelDataQ, with 2 TLV 

1- call initO method for the RECEIVE DATA 
proactive command. 

Call sendO method. 

2- call 

ProactiveResponseHandler . copyChannelData ( ) 
with dstLength lower than the value field 
of the available TLV. 

DstBuffer .length = 6 
DstOffset = 
DstLength = 6 


2- the first Channel Data TLV is 
copied into dstBuffer. 
The returned value is 
dstOffset+dstLength =0x06 


1- RECEIVE DATA 
proactive command is 
fetched 

TERMINAL RESPONSE 

with two Channel data TLV 

element 

1"' TLV: 6 bytes available = 

'HelloS' 

2""^ TLV : 6 bytes available = 

'Hello4' 


15 


Compare copied Buffer 

Check dstBuffer. 


Check that dstBuffer contains the 
first Channel Data TLV from the 
TERMINAL RESPONSE. 





5.2.5.22 Method getValueShort 

Test Area Reference: Api_2_Prh_Gvsh. 

5.2.5.22.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getValueShort (short valueOffset) 
throws ToolkitException 



5.2.5.22.1.1 



Normal execution 



• CRRNl: Gets a short from the last TLV element which has been found in the handler and returns its value 
(1 short). 



5.2.5.22.1.2 



Parameter errors 



• CRRPl : if valueOffset is out of the current TLV an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException.OUT_OF_TLV_BOUND ARIES. 



5.2.5.22.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

• CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException.UNAVAILABLE_ELEMENT. 

5.2.5.22.2 Test area files 

Specific triggering: None. 

Test Source: Test_Api_2_Prh_Gvsh.java. 
Test Applet: Api_2_Prh_Gvsh_l.java. 

Cap File: api_2_prh_gvsh.cap. 
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5.2.5.22.3 



Test coverage 



CRR number 


Test case number 


N1 


3, 4, 5, 6, 7, 8 


P1 


2 


C1 


Does not apply for Proactive Response Handler 


C2 


1 



5.2.5.22.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send a GET INPUT command 

Terminal Response, Text String length = 7Eh 

Text String TLV = OD 7F 04 01 02 ... 7E 

ProactiveResponseHandler.getTheHandlerO 

Call getValueShort (0) method 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown 


GET INPUT Proactive 
command 


2 


Search TLV Olh (Command Details TLV) 
Call getValueShort (3) method 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




3 


Search TLV Olh (Command Details TLV) 
Call getValueShort (1) method 


Result is 23h OOh (Type, qualifier) 




4 


Search TLV 02h (Device Identities TLV) 
Call getValueShort (0) method 


Result is 82h 81 h (Source, 
destination) 




5 


Search TLV ODh (Text String TLV) 
Call getValueShort (7D) method 


Result is 7Dh 7Eh 




6 


Send a GET INPUT command 

Terminal Response, Text String length = EFh 

Text String TLV = OD 81 FO 04 01 02 ... 7E 
7F ... EF 

Search TLV ODh (Text String TLV) 

Call getValueShort (7D) method 


Result is 7Dh 7Eh 


GET INPUT Proactive 
command 


7 


Call getValueShort (7F) method 


Result is 7Fh 80h 




8 


Call getValueShort (EE) method 


Result is EEh EFh 





5.2.5.23 Method getChannelStatus 

Test Area Reference: Api_2_Prh_Gcst. 

5.2.5.23.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getChannelStatus (byte channelldentif ier ) 

throws ToolkitException 

5.2.5.23.1.1 Normal execution 

• CRRNl: The method shall return the value of the first Channel Status TLV element. 

• CRRN2: The Channel Status value returned shall be from the element whose channel identifier is equal to the 
Channelldentifier parameter. 

• CRRN3: If the element is available it becomes the currently selected TLV. 

5.2.5.23.1.2 Parameter errors 
No requirements. 
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5.2.5.23.1.3 



Context errors 



• CRRC 1 : The method shall throw ToolkitException.UN AVAILABLE_ELEMENT if no Channel Status TLV 
element with the right identifier could be found. 

• CRRC2: The method shall throw ToolkitException.OUT_OF_TLV_BOUND ARIES if a Channel Status TLV 
element with the right identifier could be found but its value is less than 2 bytes long. 



5.2.5.23.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.5.23.3 



Test area files 

Test_ Api_2_Prh_Gcst.java. 
Api_2_Prh_Gcst_l .Java. 
api_2_prh_gcst.cap. 

Test coverage 



CRR number 


Test case number 


N1 


6 


N2 


5,7 


N3 


8 


C1 


1,2,3 


C2 


4 
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5.2.5.23.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Appletl is installed with maximum number 
of channel = 01. 






1 


Channel status TLV is not present 

1- Build and send a DISPLAY TEXT command 

2- Call ProactiveResponseHandler . 
getChannelStatus (0x01) method. 


2- UNAVAILABLE_ELEMENT 
ToolkitException is thrown 


1- DISPLAY TEXT Proactive 
command is fetched. 

TERMINAL RESPONSE 
with no Channel status TLV 
available. 


2 


Channel status TLV with the identifier is not 
present 

1- Build and send a OPEN CHANNEL 
proactive command 

2- Call ProactiveResponseHandler. 
getChannelStatus (0x02) method. 

3- Call 

ProactiveHandler . initCloseChannel (0x01) 
and ProactiveHandler . send methods. 


2- UNAVAILABLE_ELEMENT 
ToolkitException is thrown 


1- OPEN CHANNEL 
Proactive command is 
fetched. 

TERMINAL RESPONSE is 
issued with channel status 
value = 0x8100. 

3- Succesfull terminal 
response to 

InitCloseChannel proactive 
command. 


3 


Channel status TLV with a length equal to 

1- Build and send a OPEN CHANNEL 
proactive command 

2- Call ProactiveResponseHandler. 
getChannelStatus (0x01) method. 


2- UNAVAILABLE_ELEMENT 
ToolkitException is thrown 


1- OPEN CHANNEL 
Proactive command is 
fetched. 

TERMINAL RESPONSE 
with Channel status TLV 
length equal to 0. 


4 


Channel status TLV with a length equal to 1 

1- Build and send a OPEN CHANNEL 
proactive command 

2- Call ProactiveResponseHandler. 
getChannelStatus (0x01) method. 


2- OUT_OF_TLV_BOUNDARIES 
ToolkitException is thrown 


1- OPEN CHANNEL 
Proactive command is 
fetched. 

TERMINAL RESPONSE 
with Channel status TLV 
length equal to 1 . 


5 


Get channel status value 

1- Call ProactiveHandler . init method to 
open a channel and 
ProactiveHandler . send method. 

2- Call ProactiveResponseHandler. 
getChannelStatus (0x01) method. 

3- Build and send a get channel status 
proactive command. 


2- Returns 0x8100 


1- OPEN CHANNEL 
Proactive Command is 
fetched. 

TERMINAL RESPONSE is 
issued with channel status 
value = 0x8100. 


6 


Get channel status value with 2 TLV 

1- Build and send a get channel status 
proactive command 

2- Call ProactiveResponseHandler. 
getChannelStatus (0x01) method. 


2- Returns 0x8100 


1- Get channel status 
proactive command is 
fetched. 

TERMINAL RESPONSE is 
issued with 2 channel status 
value = 0x81 00 and 0x81 01. 
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Id 


Description 


API Expectation 


APDU Expectation 


7 


Get channel status value with 2 TLV 

1- Build and send a Get Channel status 
proactive command. 

2- Call ProactiveResponseHandler . 
getChannelStatus (0x01) method. 

4- Call 

ProactiveHandler . initCloseChannel () and 

ProactiveHandler . send ( ) methods. 


2- Returns 0x8100 


1- Get channel status 
proactive command is 
fetched. 

TERMINAL RESPONSE is 
issued with 2 channel status 
value = 0x8200 and 0x8100. 

3- Succesfull terminal 
response to 

InitCloseChannel proactive 
command. 


8 


Channel status TLV is currently selected TLV 

1- Call ProactiveHandler . init ( ) method to 
open a channel and 
ProactiveHandler . send method. 

Call ViewHandler.FindTLVO method with 
Device Identity Tag. 

2- Call ProactiveResponseHandler. 
getChannelStatus (0x03) method. 

3- Compare ProactiveResponseHandler. 
getChannelStatus and 
ViewHandler .getValueShort (0) method 
results . 

4- Call 

ProactiveHandler .initCloseChannel (0x03) 
and ProactiveHandler . send ( ) methods. 


2- Returns 0x0304 

3- Check getChannelStatus() 
=getValueShort{0) 


1- OPEN CHANNEL 
Proactive Command is 
fetched. 

TERMINAL RESPONSE is 
issued with channel status 
value = 0x0304. 

3- Succesfull terminal 
response to 

InitCloseChannel proactive 
command. 



5.2.6 Interface ToolkitConstants 
5.2.6.1 Constants 

Test Area Reference: Api_2_Tkc_Cons. 

5.2.6.1.1 Conformance requirement 

There is no API, only constants. This constants shall be compare to its definition in the API. 

5.2.6.1.1.1 Normal execution 

• CRRNl: The Toolkit Constants shall all have the same name and value as defined in TS 102 241 [13]. 



5.2.6.1.1.2 

No requirements. 

5.2.6.1.1.3 

No requirements. 

5.2.6.1.2 

None. 



Parameter errors 



Context errors 



Test area files 
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5.2.6.1.3 



Test procedure 



The constants in Java are resolved at compilation time, therefore a runtime test is not useful. No test of constants will be 
performed. 

5.2.7 Interface Toolkitlnterface 
5.2.7.1 Method processToolkit 

Test Area Reference: Api_2_Tki_Prtk. 

5.2.7.1.1 Conformance requirement: 

The method with following prototype shall be compliant to its definition in the API. 

public void processToolkit (short event) 

throws ToolkitException 



5.2.7.1.1.1 



Normal execution 



• CRRNl: This interface must be implemented by a Toolkit applet (which extends the 

javacard. framework. Applet class) so that it can be triggered by the Toolkit Triggering Entity according to the 
registration information. 

• CRRN2: The Toolkit applet will have to implement the processToolkit shared method. 

5.2.7.1.1.2 Parameter errors 
No requirements. 

5.2.7.1.1.3 Context errors 
No requirements. 

5.2.7.1.2 Test area files 

The method is tested in the CAT Runtime Environment. 



5.2.7.1.3 



Test coverage 



CRR number 


Test case number 


N1 


Tested in the whole test suite 


N2 


Tested in the whole test suite 



5.2.8 Interface ToolkitRegistry 
5.2.8.1 Method allocateTimer 

Test Area Reference: Api_2_Tkr_Atim 

5.2.8.1.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public byte allocateTimer ( ) 

throws ToolkitException 
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5.2.8.1 .1 .1 Normal execution 

CRRNl: the returned timer identifier shall be between 01 and 08 inclusive. 

CRRN2: the returned timer identifier shall be different from a previously allocated but not released one. 

CRRN3: By calling this method the applet is registered to the EVENT_TIMER_EXPIRATION of the 
allocated timer. 

CRRN4: The timer is allocated by the applet until it explicitly releases it.. 

CRRN5: When a timer is allocated, the applet can issue the Timer Management proactive command to start, 
stop or get the value of its allocated timer. 



5.2.8.1.1.2 

No requirements. 

5.2.8.1.1.3 



Parameter errors 



Context errors 



• CRRC 1 : Shall throw a ToolkitException with reason NO_TIMER_ AVAILABLE if all the timers are 
allocated. 

• CRRC2: Shall throw a ToolkitException with reason NO_TIMER_ AVAILABLE if the maximum number of 
timers have been allocated to this applet according to installation parameter. 

5.2.8.1.2 Test area files 

Test Source: Test_Api_2_Tkr_Atim.java. 
Test Applet: Api_2_Tkr_Atim_l.java. 

Api_2_Tkr_Atim_2.j ava. 

Api_2_Tkr_Atim_3 .j ava. 
Cap File: api_2_tkr_atim.cap. 

Installation parameters: 

• The maximum number of timers is as follows for each applet: 

Applet 1 (Api_2_Tkr_Atim_l): 8 timers. 
Apple t2 (Api_2_Tkr_Atim_2): 4 timers. 
Applets (Api_2_Tkr_Atim_3): timer. 



5.2.8.1.3 



Test coverage 



CRR number 


Test case number 


N1 


1,4 


N2 


1,4 


N3 


3 


N4 


3,4 


N5 


Cat Runtime Environment, 
Cre Pes Pceo 


CI 


2 


C2 


5 
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5.2.8.1.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Allocates up to 8 timers 
(Appletl) 

Call 8 times allocateTimer () and 
isEventSet (TIMER EXPIRATION). 


No exception shall be thrown. 
Timer ID returned shall be between 
01 and 08 inclusive. It shall be 
different after each call. 
Shall return true. 




2 


Allocate timers more than the maximum 
(Appletl) 

The Appletl allocates 1 more timer. 


Shall throw a ToolkitException with 
reason NO_TIMER_AVAILABLE. 




3 


Check applet is Triggered by 

ENVELOPE(TIIVIER EXPIRATION) command 

(appletl) 

Send ENVELOPE (TIMER EXPIRATION) with all 
timers id (not in an increase order) . 

Call releaselimer (id) each time a timer 
expires . 

Call IsEventSet (EVENT_TIMER_EXPIRATION) 
method 


Shall trigger each tinne an 
ENVELOPE(TIMER EXPIRATION) 
is sent to the UICC, for Timer ID = 
'01' to '08'. 
Returns false. 




4 


Allocate up to 4 timers 
(Applet2) 

Call 4 times allocateTimer () . 


No exception shall be thrown. Each 
time, the returned timer identifier 
shall be between '01' and '08' 
inclusive. It shall be different after 
each call. 




5 


Allocate timers more than the maximum 
(Applet3) 

The Applets allocates 1 more timer. 


Shall throw a ToolkitException with 
reason NO_TIMER_AVAILABLE. 





5.2.8.2 Method changeMenuEntry 

Test Area Reference: Api_2_Tkr_Cmet. 



5.2.8.2.1 



Conformance requirement: 



The method with following header shall be compliant to its definition in the API. 

public void changeMenuEntry (byte id, 

byte[] menuEntry, 
short offset, 
short length, 
byte next Act ion, 
boolean helpSupported, 
byte IconQualif ier, 
short iconldentifier) 
throws Java . lang . NullPointerException, 

Java . lang . ArraylndexOutOf BoundsException, 
ToolkitException 



5.2.8.2.1.1 



Normal execution 



CRRNl: After the invocation of this method, during the current card session, the CAT Runtime Environment 
shall dynamically update the menu stored in the Terminal. The CAT Runtime Environment shall use the data 
of the EFgujyfg file under the DF_Telecom when issuing the SET UP MENU proactive command. 

CRRN2: The default state of the changed menu entry is 'enabled'. 

CRRN3: a call to isEventSet() method on EVENT_MENU_S ELECTION shall return true before and after the 
call. 
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• 



• 



• 



• 



• 



CRRN4: if changeMenuEntryO method is called with helpSupported set to true then a call to isEventSet() 
method on EVENT_MENU_SELECTION_HELP_REQUEST event shall return true. 

CRRN5: if changeMenuEntryO method is called with helpSupported set to true andif an 

ENVELOPE(MENU_SELECTION_HELP_REQUEST) command is received by the UICC for this entry, then 
after the completion of the SET UP MENU command, the CAT Runtime Environment shall trigger the applet. 

CRRN6: if changeMenuEntryO method is called with helpsupported set to true, the CAT Runtime 
Environment shall issue a SET UP MENU command with command qualifier = '80'. 

CRRN7: if changeMenuEntryO method is called with helpSupported set to false and if no entry is supporting 
help then a call to isEventSet() method on EVENT_MENU_SELECTION_HELP_REQUEST event shall 
return false. 

CRRN8: if changeMenuEntryO method is called with helpSupported set to false, if no entry is supporting help 
and if an ENVELOPE(MENU_SELECTION_HELP_REQUEST) command is received by the UICC, then 
after the completion of the SET UP MENU command, the CAT Runtime Environment shall not trigger the 
applet. 

CRRN9: The CAT Runtime Environment shall supply in the SET UP MENU command, the icon identifier 
provided in the icon identifier list within the item icon identifier list Comprehension TLV if all the applets 
registered to the EVENT_MENU_SELECTION provide it. 

CRRNIO: The CAT Runtime Environment shall set in the SET UP MENU command, the Icon list qualifier 
transmitted to the ME as 'icon is not self explanatory', if one of the applet registered prefers this qualifier. 

• CRRN 1 1 : If Next Action Indicator is different from '00', the CAT Runtime Environment shall issue a SET UP 
MENU proactive command containing an Item Next Action Indicator Comprehension TLV with the 
comprehension flag set to as defined in TS 102 223 [7]. 

5.2.8.2.1 .2 Parameter errors 

• CRRPl: A java.lang.NullPointerException is thrown if menuEntry is null. 

• CRRP2: A java.lang.ArraylndexOutOfBoundsException is thrown if offset would cause access outside array 
bounds. 

• CRRP3: A java.lang.ArraylndexOutOfBoundsException is thrown if length would cause access outside array 
bounds. 

• CRRP4: A java.lang.ArraylndexOutOfBoundsException is thrown if both offset and length would cause 
access outside array bounds. 

5.2.8.2.1.3 Context errors 

• CRRCl : A ToolkitException with MENU_ENTRY_NOT_FOUND reason is thrown if the Menu Identifier 
isn't associated to the calling applet instance. 

• CRRC2: A ToolkitException with ALLOWED_LENGTH_EXCEEDED reason is thrown if the menu entry 
string is bigger than the allocated space. 

5.2.8.2.2 Test area files 

Additional requirements for the UICC personalization: 

• content of EF sume shall be: 

Tide Alpha Identifier: "TOOLKIT TEST" . 
Test Source: Test_Api_2_Tkr_Cmet.java. 

Test Applet: Api_2_Tkr_Cmet_Ljava. 

entry'01'is"Initl". 
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entry'02'is"Init2". 
Installation parameter: 

• Same as default applet but with: 

Maximum text length for a menu entry: 
Maximum number of menu entries: 
Position / Identifier for each menu entry: 

Cap File: api_2_tkr_cmet.cap. 



15. 

2. 

'017'01','027'02'. 



5.2.8.2.3 



Test coverage 



5.2.8.2.4 



CRR number 


Test case number 


N1 


1,2,3,4,6,8,9,20 


N2 


9 


N3 


1,2,3,4,6,8,9,20 


N4 


6 


N5 


7,5 


N6 


6 


N7 


1,2,3,4,8,9,20 


N8 


Tested in CAT Runtime Environment: 
Cre Apt Emsli (Test case 1 ) 


N9 


8,9 


N10 


8 


N11 


4 


P1 


10 


P2 


11, 12, 13 


P3 


14, 15 


P4 


16 


C1 


17, 18 


C2 


19 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Applet changes the entry's title by menuEntry 

buffer, with a greater length than the initial 

length 

1- Call changeMenuEntry ( ) with 
parameters : 

Id = '02' 

MenuEntry = "UseAllBuf f er " 

Offset = 

Length = menuEntry . length 

NextAction = 

HelpSupported = false 

IconQualif ier = 

Iconldentif ier = 0. 

2- Call isEventSet (EVENT_MENU_SELECTION) . 

3- Call 

IsEventSet (EVENT_MENU_SELECTION_HELP_REQUE 
ST) . 


1- No exception shall be tlirown. 

2- shall return true. 

3- shall return false. 


The UICC shall issue a 
SETUP MENU proactive 
command which contains 
the new text for entry ID 
'02'. 
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Id 


Description 


API Expectation 


APDU Expectation 


2 


Changing the title with part of menuEntry 
buffer 

1- Call ChangeMenuEntry ( ) with 
parameters : 








Id = '01' 


1- No exception shall be thrown. 






MenuEntry = "UsePartOfBuf f er " 








Offset = 3 


2- Shall return true. 






Length = 12 








NextAction = 
HelpSupported = false 


3- Shall return false. 






IconQualif ier = 








Iconldentif ier = 0. 








2- Call isEventSet (EVENT_MENU_SELECTION) . 




The UICC shall issue a 




3- Call 




SETUP MENU proactive 




isEventSet (EVENT_MENU_SELECTION_HELP_REQUE 




command which contains 




ST) 




the new text for entry ID 
'01'. 


3 


Length = 

1- Call ChangeMenuEntry ( ) for entry '01' 
and entry '02', with parameters: 

Id = '01'/'02' 

MenuEntry = "LengthEqualsO " 








Offset = 


1- No exception shall be thrown. 






Length = 








NextAction = 


2- Shall return true. 






HelpSupported = false 








IconQualif ier = 


3- shall return false. 






Iconldentif ier = 0. 








2- Call IsEventSet (EVENT_MENU_SELECTION) . 








3- Call 




The UICC shall issue a 




isEventSet (EVENT_MENU_SELECTION_HELP_REQUE 




SETUP MENU proactive 




ST) . 




command which contains 
for entry '01 'and entry '02', 
no text part. 


4 


Setting a next action indicator != 

1- Call changeMenuEntry ( ) with 
parameters : 

Id = '02' 

MenuEntry = "NextActionlndic" 

Offset = 

Length = menuEntry . length 

NextAction = '10' (SETUP CALL) 

HelpSupported = false 

IconQualif ier = 

Iconldentif ier = 


1 - No exception shall be thrown. 






2- Call isEventSet (EVENT_MENU_SELECTION) . 


2- Shall return true. 

3- Shall return false. 






3- Call 








isEventSet (EVENT_MENU_SELECTION_HELP_REQUE 








ST) . 








4- Call changeMenuEntry ( ) with parameters: 








Id = '02' 








MenuEntry = "NextActionlndic" 








Offset = 




The UICC shall issue a 




Length = menuEntry . length 
NextAction = '10' (SETUP CALL) 




SETUP MENU proactive 




HelpSupported = true 




command which contains an 




IconQualif ier = 




Items Next Action Indicator 




Iconldentif ier = 




list and which contains a 
command qualifier '80'. 



£75/ 
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Id 


Description 


API Expectation 


APDU Expectation 


5 


Checking applet is triggered by a 
MENU_SELECTION_HELP_REQUEST 

Send ENVELOPE (MENU_SELECTION_HELP_REQUEST) 
with Item Identifier = '02' 


Applet is triggered by a 
MENU_SELECTION_HELP_REQU 
EST and the Item Identifier is 02 




6 


help supported=true 

1- Call changeMenuEntry ( ) with 
parameters : 








Id = '01' 

MenuEntry = "HelpSupported" 

Offset = 

Length = menuEntry . length 

NextAction = 

HelpSupported = true 

IconQualif ier = 

Iconldentifier = 


1- No exception shall be thrown. 

2- Shall return true. 

3- Shall return true. 






2- Call isEventSet (EVENT_MENU_SELECTION) . 








3- Call 

isEventSet (EVENT_MENU_SELECTION_HELP_REQUE 

ST) . 




The UICC shall issue a 
SETUP MENU proactive 
command which contains a 
command qualifier '80'. 


7 


Checking applet is triggered by a 
MENU_SELECTION_HELP_REQUEST 

Send ENVELOPE (MENU_SELECTION_HELP_REQUEST) 
with Item Identifier = '01' 


Applet is triggered by a 
MENU_SELECTION_HELP_REQU 
EST and the Item Identifier is 01 




8 


Setting icons, help supported = false 

1- call ChangeMenuEntry ( ) for entries 
'01', '02', with parameters: 








Id = '01'/'02' 

MenuEntry = " IconQualif ier " 

Offset = 

Length = menuEntry . length 

NextAction = 

HelpSupported = false 

IconQualif ier = '01' 

Iconldentifier = '02' / '01' 


1 - No exception shall be thrown. 

2- Shall return true. 

3- Shall return false. 






2- Call IsEventSet (EVENT_MENU_SELECTION) . 








3- Call 

isEventSet (EVENT_MENU_SELECTION_HELP_REQUE 

ST) . 




The UICC shall issue a 
SETUP MENU proactive 
command which contains an 
Icon Identifier List. 


9 


MenuEntry is disabled 

1- Call disableMenuEntry ( '01' ) . 

2- Call changeMenuEntry ( ) with 
parameters ; 








Id = '01' 


1- No exception shall be thrown. 






MenuEntry = "EnableEntry " 
Offset = 

Length = menuEntry . length 
NextAction = 
HelpSupported = false 
IconQualif ier = 
Iconldentifier = 

3- Call IsEventSet (EVENT_MENU_SELECTION) . 

4- Call 

isEventSet (EVENT_MENU_SELECTION_HELP_REQUE 
ST) . 


2- No exception shall be thrown. 

3- Shall return true. 

4- Shall return false. 


The UICC shall issue a 
SETUP MENU proactive 
command which contains 
the entry. Without Icon 
identifier List 
Comprehension TLV 
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Id 


Description 


API Expectation 


APDU Expectation 


10 


MenuEntry is null 

Call ChangeMenuEntry ( ) method with 
parameters ; 
MenuEntry = NULL 


Shall throw 
java.lang.NullPointerException. 




11 


Offset causes access outside array bounds 

changeMenuEntry ( ) 
Id = '01' 

MenuEntry = "Violation" 
Offset = menuEntry . length +1 
Length = 
NextAction = 
HelpSupported = false 
IconQualif ier = 
Iconldentif ier = 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 

xception. 




12 


Big Offset causes access outside array bounds 

ChangeMenuEntry ( ) 

Id = '01' 

MenuEntry = "Violation" 

Offset = 255 

Length = 1 

NextAction = 

HelpSupported = false 

IconQualif ier = 

Iconldentif ier = 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 

xception. 




13 


Offset < causes access outside array bounds 

changeMenuEntry ( ) 

Id = '01' 

MenuEntry = "Violation" 

Offset = -1 

Length = 1 

NextAction = 

HelpSupported = false 

IconQualif ier = 

Iconldentif ier = 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 

xception. 




14 


Length causes access outside array bounds 

changeMenuEntry ( ) 

Id = '01' 

MenuEntry = "Violation" 

Offset = 

Length = MenuEntry . length + 1 

NextAction = 

HelpSupported = false 

IconQualif ier = 

Iconldentif ier = 0. 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 

xception. 




15 


Length < causes access outside array 
bounds 

changeMenuEntry ( ) 
Id = '01' 

MenuEntry = "Violation" 
Offset = 
Length = -1 
NextAction = 
HelpSupported = false 
IconQualif ier = 
Iconldentif ier = 0. 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 

xception. 




16 


Both offset and length causes access outside 
array bounds 

changeMenuEntry ( ) 
Id = '01' 

MenuEntry = "Violation" 
Offset G [1, MenuEntry . length] 
Length = MenuEntry . length 
NextAction = 1 
HelpSupported = false 
IconQualif ier = 
Iconldentif ier = 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 

xception. 
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Id 


Description 


API Expectation 


APDU Expectation 


17 


Invalid ID used 

changeMenuEntry ( ) 

Id = '00' 

MenuEntry = contains text, != null 

Offset = 

Length = menuEntry . length < 16 

NextAction = 

HelpSupported = false 

IconQualif ier = 

Iconldentif ier = 


Shall throw a ToolkitException with 
l\/IENU_ENTRY_NOT_FOUND 
reason code. 




18 


ID isn't allocated to a menu entry of this applet 
instance 

changeMenuEntry ( ) 

Id = 'OA' 

MenuEntry = contains text, != null 

Offset = 

Length = menuEntry . length < 16 

NextAction = 

HelpSupported = false 

IconQualif ier = 

Iconldentif ier = 


Shall throw a ToolkitException with 
reason code: 
MENU_ENTRY_NOT_FOUND. 




19 


The text is bigger than the allocated space 

changeMenuEntry ( ) 

Id = '02' 

MenuEntry = contains text, != null 

Offset = 

Length = menuEntry . length > 15 

NextAction = 

HelpSupported = false 

IconQualif ier = 

Iconldentif ier = 


Shall throw a ToolkitException with 
reason code: 
ALLOWED_LENGTH_EXCEEDED. 




20 


With a smaller text length than the initial length 

1. changeMenuEntry () with parameters: 

Id = '02' 

MenuEntry = "Init" 
Offset = 

Length = menuEntry . length 
NextAction = 
HelpSupported = false 
IconQualif ier = 
Iconldentif ier = 

2. Call isEventSet (EVENT_MENU_SELECTION) 

3. Call 

isEventSet (EVENT_MENU_SELECTION_HELP„REQUE 
ST) 


1 . No exception shall be thrown. 

2. Shall return true. 

3. Shall return false. 


The UICC shall issue a 
SETUP MENU proactive 
command which contains 
the new text for entry ID 
'02'. 



5.2.8.3 Method clearEvent 

Test Area Reference: Api_2_Tkr_Cevt. 

5.2.8.3.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public void clearEvent (short event) 

throws ToolkitException, 

javacard. framework . Trans act ionExcept ion 
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5.2.8.3.1.1 Normal execution 

• CRRNl: A call to isEventSet() method for a cleared event shall return false after a call to clearEvent. 

• CRRN2: The CAT Runtime Environment shall not trigger the applet on the occurrence of the cleared event 
anymore. 

• CRRN3: After the call to clearEvent() method with EVENT_CALL_CONTROL_BY_NAA event, no applet is 
registered to this event, and the CAT Runtime Environment shall allow an applet to register to this event. 

• CRRN4: If an applet is still registered to EVENT_CALL_CONTROL_BY_NAA event, the CAT Runtime 
Environment shall not allow an applet to register to it. 



5.2.8.3.1.2 



Parameter errors 



CRRPl: Shall throw a Toolkit Exception with reason EVENT_NOT_ALLOWED if event is 
EVENT_MENU_SELECTION. 

CRRP2: Shall throw a Toolkit Exception with reason EVENT_NOT_ALLOWED if event is 
EVENT_MENU_SELECTION_HELP_REQUEST. 

CRRP3: Shall throw a Toolkit Exception with reason EVENT_NOT_ALLOWED if event is 
EVENT_TIMER_EXPIRATION. 

CRRP4: Shall throw a Toolkit Exception with reason EVENT_NOT_ALLOWED if event is 
EVENT_STATUS_COMMAND. 

CRRP5: Shall throw a Toolkit Exception with reason EVENT_NOT_ALLOWED if event is 
EVENT_EVENT_DOWNLOAD_LOCAL_CONNECTION. 



5.2.8.3.1.3 



Context errors 



• CRRCl: shall throw javacard.framework.TransactionException - if the operation would cause the commit 
capacity to be exceeded. 



5.2.8.3.2 

Test Source: 
Test Applet: 



Test area files 

Test_Api_2_Tkr_Cevt.j ava. 
Api_2_Tkr_Cevt_ 1 .j ava. 



• As default but applet registers to an event list which contains all defined events in TS 102 241 [13] excepted 
those that are not allowed or supported by setEvent(). 



Cap File: 
5.2.8.3.3 



api_2_tkr_cevt.cap. 

Test coverage 



CRR number 


Test case number 


N1 


1,2 


N2 


4 


N3 


Tested in CAT Runtime 
Environment, Cre Apt Eccn 


N4 


Tested in CAT Runtime 
Environment, Cre Apt Eccn 


P1 


3 


P2 


3 


P3 


3 


P4 


3 


P5 


3 


C1 


not testable 
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5.2.8.3.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Clear ALLOWED unregistered events 

For events ranging from -1, 1, 7 to 9, 11 
to 23, 25 to 29, 123, 124, 126 and 127* 
excepted those that aren't allowed (7, 8, 
11, 19, 27), the applet calls: 

1- Call clearEventO method 

2- Call isEventSetO method 


1 - No exception is tlirown each 
time. 

2- Shall return false each time. 




2 


Clear registered events 

1- For each ALLOWED and SUPPORTED event 
(-1, 1, 7 to 9, 11 to 23, 25 to 29, 123, 
124, 126 and 127)* excepted (7, 8, 11, 19, 
27, 124), the applet calls setEventO 
method. Call registerFileEvent () method. 

2- For each ALLOWED and SUPPORTED event 
(-1, 1, 7 to 9, 11 to 23, 25 to 29, 123, 
124, 126 and 127)* excepted (7, 8, 11, 19, 
27) , the applet calls: 

2.1- Call ClearEventO method 

2.2- Call isEventSetO method 


1 - No exception shall be thrown. 
2.1 - No exception shall be thrown. 
2.2- Shall return false. 




3 


Clear NOT ALLOWED events 

For each event among: 
EVENT_MENU_SELECTION, 
EVENT_MENU_SELECTION_HELP„REQUEST, 
EVENT_TIMER_EXPIRATION, 
EVENT_STATUS_COMMAND, 

EVENT_EVENT_DOWNLOAD_LOCAL_CONNECT I ON , 
1- The applet calls clearEvent (event) 
method. 


1- Each time, clearEvent shall 
throw a ToolkitException with 
reason EVENT_NOT_ALLOWED. 




4 


Check applet Is not triggered by an 

ENVELOPE(EVENT EVENT DOWNLOAD USE 

R_ACTIVITY) command 

1 - reset and initialize the card 

2 - An 

ENVELOPE (EVENT_EVENT_DOWNLOAD_USER_ACTI VI T 
Y) is sent. 


Applet is not triggered by an 
ENVELOPE(EVENT EVENT DO 
WNLOAD_USER_ACTIVITY) 
command 





NOTE: Although the clearEventO method is defined for large range, only the allowed events are tested here, 
because a range is reserved for propriatary use in TS 102 241 [13], clause 4, and a range is omitted for 
compatibility with future releases of TS 102 241 [13]. 

5.2.8.4 Method disableMenu Entry 

Test Area Reference: Api_2_Tkr_Dmet. 

5.2.8.4.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public void disableMenuEntry (byte id) 

throws ToolkitException 

5.2.8.4.1.1 Normal execution 

• CRRNl : This method does not modify the registration state to the EVENT_MENU_S ELECTION. 

• CRRN2: This method does not modify the registration state to the 
EVENT_MENU_SELECTION_HELP_REQUEST. 
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• CRRN3: After invocation of this method, during the current card session, the CAT Runtime Environment shall 
dynamically update the menu stored in the ME. 

• CRRN4: After invocation of this method, if there is no more enabled menu entries then the CAT Runtime 
Environment shall issue a SETUP MENU proactive command containing Item Data Object for Item 1 TLV 
with a length of zero and no value part. 



5.2.8.4.1.2 

No requirements. 

5.2.8.4.1.3 



Parameter errors 



Context errors 



CRRCl: shall throw a ToolkitException with reason ENTRY_NOT_FOUND if the menu entry does not exist 
for this applet. 



5.2.8.4.2 Test area files 

Test Source: Test_Api_2_Tkr_Dmet.java. 
Test Applet: Api_2_Tkr_Dmet_l.java. 

Cap File: api_2_tkr_dmet.cap. 

• Installation parameter: 

Same as default applet but with: 

■ Maximum text length for a menu entry: 

■ Maximum number of menu entries: 

■ Position / Identifier for each menu entry: 

• Additional requirements for the UICC personalization: 

content of EF sume shall be: 

■ Title Alpha Identifier: 



15. 

2. 

'Ol'/'Or, '02702'. 



"TOOLKIT TEST". 



5.2.8.4.3 



Test coverage 



CRR number 


Test case number 


N1 


1,2,3,4 


N2 


1,2,3,4 


N3 


2,4 


N4 


4 


CI 


5 
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5.2.8.4.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Check the menu state before 

disabling a previously enabled entry 

not registered to 

EVENT_MENU_SELECTION_HELP_REQUEST 

1- reset and initialize the card 

2- Call isEventSet (EVENT_MENU_SELECTION) 

3- Call 

isEventSet (EVENT_MENU_SELECTION_HELP_REQUE 
ST) 


1- Shall return true 

2- Shall return false 


1- The UICC shall issue a 
SET UP MENU proactive 
command with entry '01' 
and '02'. 


2 


Check the menu state after 

disabling a previously enabled entry 

not registered to 

EVENT_MENU_SELECTION_HELP_REQUEST 

1- Call disableMenuEntry ( ' 01 ' ) 

2- Call IsEventSet (EVENT_MENU_SELECTION) 

3- Call 

IsEventSet (EVENT_MENU_SELECTION_HELP_REQUE 
ST) 


1 - No exception shall be thrown. 

2- Shall return true. 

3- Shall return false. 


3- The UICC shall issue a 
SET UP MENU proactive 
command with entry '02' 
only. 


3 


Check the menu before 

disabling a previously enabled entry 

registered to 

EVENT_MENU_SELECTION_HELP_REQUEST 

1- change Menu Entry ' 02 ' to indicate 
help supported 

2- Call IsEventSet (EVENT_MENU_SELECTION) 

3- Call 

IsEventSet {EVENT_MENU_SELECTION_HELP_REQUE 
ST) 


2- Shall return true 

3- Shall return true 


3- The UICC shall issue a 
SET UP MENU proactive 
command with entry '02', 
indicating help supported. 


4 


Check the menu after 

disabling a previously enabled entry 

registered to 

EVENT_MENU_SELECTION_HELP_REQUEST 

1- Call disableMenuEntry (' 02 ' ) 

2- Call IsEventSet (EVENT_MENU_SELECTION) 

3- Call 

IsEventSet (EVENT_MENU_SELECTION_HELP_REQUE 
ST) 


1 - No exception shall be thrown. 

2- Shall return true. 

3- Shall return true. 


3- The UICC shall issue a 
SET UP MENU proactive 
command with 1st Item TLV 
with a length of 0. 


5 


Disabling invalid entries 

For ID ranging from '00' to ' FF ' except 
'01' and '02', the applet calls 
disableMenuEntry (ID) method. 


Each time a Toolkit Exception with 
MENU_ENTRY_NOT_FOUND 
reason code shall be thrown. 





5.2.8.5 Method enableMenuEntry 

Test Area Reference: Api_2_Tkr_Emet. 

5.2.8.5.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public void enableMenuEntry (byte id) 

throws ToolkitException 
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5.2.8.5.1.1 



Normal execution 



CRRNl: A call to isEventSet() method on EVENT_MENU_SELECTION shall return the same result before 
and after the call to enableMenuEntryO method. 

CRRN2: A call to isEventSet() method on EVENT_MENU_SELECTION_HELP_REQUEST shall return the 
same result before and after the call to enableMenuEntryO method. 

CRRN3:The CAT Runtime Environment shall dynamically issue a SETUP MENU proactive command which 
does contain an ITEM COMPREHENSION TLV object for this entry. 



5.2.8.5.1.2 

No requirements. 

5.2.8.5.1.3 



Parameter errors 



Context errors 



• CRRCl : shall throw a ToolkitException with reason MENU_ENTRY_NOT_FOUND if the menu entry 
doesn't exist for this applet. 

5.2.8.5.2 Test area files 

Additional requirements for the UICC personalization: 

• content of EF sume shall be: 

Title Alpha Identifier: "TOOLKIT TEST". 

Test Source: Test_Api_2_Tkr_Emet.java. 

Test Applet: Api_2_Tkr_Emet_l.java. 

• Installation parameter: 

Same as default applet but with: 

■ Maximum text length for a menu entry: 15. 

■ Maximum number of menu entries: 2. 

■ Position / Identifier for each menu entry: 'Ol'/'Ol', '027'02'. 
Cap File: api_2_tkr_emet.cap. 



5.2.8.5.3 



Test coverage 



CRR number 


Test case number 


N1 


1,2,3,4 


N2 


1,2,3,4 


N3 


1,2,3,4 


C1 


5 
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5.2.8.5.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Check menu state before 

enabling a previously disabled entry 

not registered to 

EVENT_MENU_SELECTION_HELP_REQUEST 

1- Call isEventSet (EVENT_MENU_SELECTION) 

2- Call 

isEventSet (EVENT_MENU_SELECTION_HELP_REQUE 
ST) 

3- Call disableMenuEntry ( ' 01 ' ) 


1- Shall return true 

2- Shall return false 

3- No exception shall be thrown. 


3- The UICC shall issue a 
SET UP MENU proactive 
command with entry '02' 
only. 


2 


Check menu state after 

enabling a previously disabled entry 

not registered to 

EVENT_MENU_SELECTION_HELP_REQUEST 

1- Call enableMenuEntry ( ' 01 ' ) 

2- Call IsEventSet (EVENT_MENU_SELECTION) 

3- Call 

IsEventSet (EVENT_MENU_SELECTION_HELP_REQUE 
ST) 


1 - No exception shall be thrown. 

2- Shall return true. 

3- Shall return false. 


3- The UICC shall issue a 
SET UP MENU proactive 
command with entry '01' 
and '02'. 


3 


Check menu state before 

enabling a previously enabled entry 

registered to 

EVENT_MENU_SELECTION_HELP_REQUEST 

1- change Menu Entry ' 02 ' to indicate 
help supported 

2- Call IsEventSet (EVENT_MENU_SELECTION) 

3- Call 

IsEventSet (EVENT_MENU_SELECTION_HELP_REQUE 
ST) 

4- Call disableMenuEntry (' 02 ' ) 


2- Shall return true 

3- Shall return true 

4- No exception shall be thrown 


4- The UICC shall issue a 
SET UP MENU proactive 
command with entry '01'. 


4 


Check menu state after 

enabling a previously enabled entry 

registered to 

EVENT_MENU_SELECTION_HELP_REQUEST 

1- Call enableMenuEntry (' 02 ') ■ 

2- Call IsEventSet (EVENT_MENU_SELECTION) 

3- Call 

IsEventSet (EVENT_MENU_SELECTION_HELP_REQUE 
ST) 


1- No exception shall be thrown. 

2- Shall return true. 

3- Shall return true. 


3- The UICC shall issue a 
SET UP MENU proactive 
command with entries '01' 
and '02' indicating help 
supported. 


5 


Enabling invalid entries 

For ID ranging from '00' to ' FF ' except 
'01' and '02', the applet calls 
enableMenuEntry (ID) method. 


Each time a Toolkit Exception with 
MENU_ENTRY_NOT_FOUND 
reason code shall be thrown. 





5.2.8.6 Method getPolllnterval 

Test Area Reference: Api_2_Tkr_Gpol. 

5.2.8.6.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public short getPolllnterval () 



5.2.8.6.1.1 



Normal execution 



CRRNl: shall return a value between 1 and 15300 if applet is registered to EVENT_STATUS_COMMAND 
event. 

CRRN2: shall return POLL_NO_DURATION value (0) if the toolkit applet is not registered to 
EVENT_STATUS_COMMAND event. 
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5.2.8.6.1.2 

No requirements. 

5.2.8.6.1.3 

No requirements. 

5.2.8.6.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.8.6.3 



Parameter errors 
Context errors 
Test area files 

Test_Api_2_Tkr_Gpol.j ava. 
Api_2_Tkr_Gpol_l .Java. 
api_2_tkr_gpol.cap. 

Test coverage 



CRR number 


Test case number 


N1 


2,3 


N2 


1,4 



5.2.8.6.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Applet isn't registered to 
EVENT_STATUS_COMIVIAND 

Call getPolllntervalQ method. 


Shall return 0. 




2 


Requesting max duration 

1- Call requestPollInterval (15300) 

2- Reset and initialize the card 

3- Call getPollInterval method 


1 - No exception shall be thrown. 

3- Shall return a value between 1 
and 15300. 




3 


Requesting System Duration 

1- Call 

requestPollInterval (POLL_SYSTEM_DURATION) 

2- Reset and initialize the card 

3- Call getPollInterval method. 


1 - No exception shall be thrown. 
3- Shall return a value between 1 
and 15300. 




4 


Requesting no Duration 

1- Call 

requestPollInterval {POLL_NO_DURATION) 

2- Reset and initialize the card 

3- Call getPollInterval method. 


1 - No exception shall be thrown. 
3- Shall return 0. 
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5.2.8.7 Method initMenuEntry 

Test Area Reference: Api_2_Tkr_Imet. 

5.2.8.7.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the APT 

public byte initMenuEntry (byte [ ] menuEntry, 

short offset, 
short length, 
byte nextAction, 
boolean helpSupported, 
byte IconQualif ier, 
short iconldentif ier ) 
throws Java . lang . NullPointerException, 

Java . lang. ArraylndexOutOfBoundsException, 
ToolkitException 

5.2.8.7.1.1 Normal execution 

• CRRNl: The CAT Runtime Environment shall automatically update the menu stored in the ME by issuing a 
SETUP MENU proactive command. The later will reflect the changes done for the entry. The CAT Runtime 
Environment shall use the data of the EFsume file in order to build the SET UP MENU command. 

• CRRN2: a call to isEventSet() method on EVENT_MENU_S ELECTION shall return true after the l" 
successful call (without an exception). 

• CRRN3: if helpSupported was true then a following call to isEventSet() method on 
EVENT_MENU_SELECTION_HELP_REQUEST event shall return true. 

• CRRN4: if helpSupported was true then after the completion of the SETUP MENU command, if an 
ENVELOPE(MENU_SELECTION_HELP_REQUEST) command is received by the UICC for this entry, then 
the CAT Runtime Environment shall trigger the applet. 

CRRN5: if help supported was true, the CAT Runtime Environment shall issue a SETUP MENU command 
with command qualifier = '80'. 

CRRN6: if helpSupported was false and there isn't any menu entry supporting help then a call to isEventSet() 
method on EVENT_MENU_SELECTION_HELP_REQUEST event shall return false. 

CRRN7: The CAT Runtime Environment shall supply in the SET UP MENU command with the icon 
identifier provided in the icon identifier list within the item icon identifier list Comprehension TLV if all the 
applets registered to the EVENT_MENU_SELECTION provide it. 

CRRN8: The CAT Runtime Environment shall set in the SET UP MENU command with the Icon list qualifier 
transmitted to the ME as 'icon is not self explanatory' if one of the applet registered prefers this qualifier. 

CRRN9: If Next Action Indicator was different from '00', the CAT Runtime Environment shall issue a SETUP 
MENU proactive command containing an Items Next Action Indicator Comprehension TLV with the 
comprehension flag set to 0. 

CRRNIO: After the completion of the SETUP MENU command, if an ENVELOPE (MENU_SELECTION) 
command is received by the UICC for this identifier, then the CAT Runtime Environment shall trigger the 
applet. 

5.2.8.7.1 .2 Parameter errors 

• CRRPl : Shall throw java.lang.NuUPointerException - if menuEntry is null. 

• CRRP2: Shall throw java.lang. ArraylndexOutOfBoundsException - if offset would cause access outside array 
bounds. 

• CRRP3: Shall throw java.lang. ArraylndexOutOfBoundsException - if length would cause access outside array 
bounds. 



• 



• 



• 
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• CRRP4:Shall throw java.lang.ArraylndexOutOfBoundsException - if both offset and length would cause 
access outside array bounds. 



5.2.8.7.1.3 



Context errors 



• CRRC 1 : Shall throw ALLOWED_LENGTH_EXCEEDED if the menu entry string is bigger than the allocated 
space. 

• CRRC2: Shall throw REGISTRY_ERROR if the menu entry cannot be initialized (eg no more item data in 
applet loading parameter). 

5.2.8.7.2 Test area files 

Additional requirements for the UICC personalization: 

• content of EFsume shall be: 

Tide Alpha Identifier: "TOOLKIT TEST" 
Test case trigger: 

■ 1- Applet instanciation. 

■ 2- Menu selection. 

■ 3- Menu selection Help Supported. 

Test Source: Test_Api_2_Tkr_Imet.java 

Test Applet: Api_2_Tkr_Imet_l.java. 

• Installation parameter: 

Same as default applet but with: 

■ Maximum text length for a menu entry: 15. 

■ Maximum number of menu entries: 6. 

Position / Identifier for each menu entry: 'Ol'/'Ol', '02702', '03'/'03', '04'/'04', '05'/'05', and '06'/'06'. 
Cap File: api_2_tkr_imet.cap. 



5.2.8.7.3 



Test coverage 



CRR number 


Test case number 


N1 


16 


N2 


9 


N3 


11 


N4 


22 


N5 


11, 16 


N6 


10 


N7 


12,16 


N8 


12,16 


N9 


13,16 


N10 


9, 10, 11, 12, 13, 14, 17, 18, 19,20,21,23 


P1 


1 


P2 


2, 3,4 


P3 


5,6 


P4 


7 


01 


8 


C2 


14 
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5.2.8.7.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


NULL as parameter to menuEntry 

initMenuEntry ( ) 
MenuEntry = NULL 


Shall throw a 
java.lang.NullPointerException. 




2 


Offset > menuEntry.length 

initMenuEntry () 
MenuEntry = "ToolkitTest " 
Offset = 12 
Length = 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 

xception. 




3 


Offset < 

initMenuEntry () 
MenuEntry = "ToolkitTest" 
Offset = -1 
Length =11 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 

xception. 




4 


Offset = 255 

InitMenuEntry () 
MenuEntry = "ToolkitTest" 
Offset = 255 
Length =11 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 

xception. 




5 


Length = menuEntry.length+1 

initMenuEntry () 
MenuEntry = "ToolkitTest" 
Offset = 
Length = 12 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 

xception. 




6 


Length < 

initMenuEntry ( ) 
MenuEntry = "ToolkitTest" 
Offset = 
Length = -1 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 

xception. 




7 


Offset + length > menuEntry.length 

initMenuEntry () 
MenuEntry = "ToolkitTest" 
Offset = 11 
Length = 1 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 

xception. 




8 


MenuEntry.length > size allocated at loading 
for each menu entry 

InitMenuEntry () 

MenuEntry = "ToolkitTest impossible" 

Offset = 

Length = 16 


ALLOWED_LENGTH_EXCEEDED 
ToolkitException is thrown. 




9 


Successful call, 
menuEntry is the whole buffer 

1- Call InitMenuEntry method 

MenuEntry = "TOOLKIT TEST 1" 
Offset = 
Length = 14 
NextAction = '00' 
HelpSupported = false 
IconQualif ier = '00' 
Iconldentif ier = 

2- Call isEventSet {EVENT_MENU_SELECTION) 


1- No exception shall be thrown, 
Shall return ID '01'. 

2- Shall return true. 




10 


Successful call, 
menuEntry part of a buffer 

1- Call InitMenuEntry method 

MenuEntry = " 1234567TOOLKIT TEST 2" 
Offset = 7 
Length = 14 
NextAction = '00' 
HelpSupported = false 


1- No exception shall be 
thrown, Shall return ID '02'. 

2- Shall return false. 
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Id 


Description 


API Expectation 


APDU Expectation 




IconQualif ier = '00' 
Iconldentif ier = 

2- Call 

isEventSet (EVENT_MENU_SELECTION_HELP_REQUE 

ST) 






11 


Successful call, 
menuEntry with help supported 

1- Call InitMenuEntry method 

MenuEntry = "TOOLKIT TEST 3" 
Offset = 
Length =14 
NextAction = '00' 
HelpSupported = true 
IconQualif ier = '00' 
Iconldentif ier = 

2- Call 

isEventSet (EVENT_MENU_SELECTION_HELP_REQUE 
ST) 


1- No exception shall be thrown, 
Shall return ID '03' 

2- Shall return true. 




12 


Successful call, 
menuEntry with an Icon 

InitMenuEntry ( ) 

MenuEntry = "TOOLKIT TEST 4" 

Offset = 

Length = 14 

NextAction = '00' 

HelpSupported = false 

IconQualif ier = '01' [icon not self 

explanatory] 

Iconldentif ier = 1 


1- No exception shall be thrown. 

2- Shall return ID '04' 




13 


Successful call, 
menuEntry with a next action indication 

InitMenuEntry () 

MenuEntry = "TOOLKIT TEST 5" 

Offset = 

Length = 14 

NextAction = '24' [Select Item] 

HelpSupported = false 

IconQualif ier = '00' 

Iconldentif ier = 


1- No exception shall be thrown. 

2- Shall return ID '05' 




14 


Successful call, 
length = 

Call InitMenuEntry method 

MenuEntry = "ToolkitTest" 
Offset = 
Length = 
NextAction = '00' 
HelpSupported = false 
IconQualif ier = '00' 
Iconldentif ier = 


No exception shall be thrown, hall 
return ID '06'. 




15 


Initialize more entry than allocated at loading 

InitMenuEntry () 
MenuEntry = "ToolkitTest" 
Offset = 
Length =11 


REGISTRY_ERROR 
ToolkitException is thrown. 
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Id 


Description 


API Expectation 


APDU Expectation 


16 


Dynamic update of the menu stored by the ME 

Fetch the setup menu proactive command 




Card shall send a 

SetUpMenu Proactive 

command: 

[CommandOualifier]=help 

supported 

[Alphald]="TOOLKIT TEST" 

[ltemld=1] = "TOOLKIT 

TEST 1 " 

[ltemld=2] = "TOOLKIT 

TEST 2" 

[ltemld=3] = "TOOLKIT 

TEST 3" 

[ltemld=4] = "TOOLKIT 

TEST 4" 

[ltemld=5] = "TOOLKIT 

TEST 5" 

[ltemld=6] = "" 

[ltemsNextAction]=0600000 

0002400 


17 


Check Applet is triggered by 
envelope(MENU_SELECTION) command 

Menu Entry ID = '01' 


Applet is triggered by an 
ENVELOPE(MENU_SELECTION) 
command & Menu Entry ID = '01' 




18 


Check Applet is triggered by envelope 
(MENU_SELECTION) command 

Menu Entry ID = '02' 


Applet is triggered by an 
ENVELOPE(MENU_SELECTION) 
command & Menu Entry ID = '02' 




19 


Check Applet is triggered by envelope 
(MENU_SELECTION) command 

Menu Entry ID = '03' 


Applet is triggered by an 
ENVELOPE(MENU_SELECTION) 
command & Menu Entry ID = '03' 




20 


Check Applet is triggered by envelope 
(MENU_SELECTION) command 

Menu Entry ID = '04' 


Applet is triggered by an 
ENVELOPE(MENU_SELECTION) 
command & Menu Entry ID = '04' 




21 


Check Applet is triggered by envelope 
(MENU_SELECTION) command 

Menu Entry ID = '05' 


Applet is triggered by an 
ENVELOPE(MENU_SELECTION) 
command & Menu Entry ID = '05' 




22 


Check Applet is triggered by envelope 

(MENU_SELECTION_HELP_REQUEST) 

command 

Menu Entry ID = '03' 


Applet is triggered by an 
ENVELOPE(MENU SELECTION 
HELP_REQUEST) command & 
Menu Entry ID = '03' 




23 


Check Applet is triggered by envelope 
(MENU_SELECTION) command 

Menu Entry ID = '06' 


Applet is triggered by an 
ENVELOPE(MENU_SELECTION) 
command & Menu Entry ID = '06' 
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5.2.8.8 Method isEventSet 

Test Area Reference: Api_2_Tkr_Ievs. 

5.2.8.8.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the APT 

public boolean isEventSet (short event) 

5.2.8.8.1.1 Normal execution 

• CRRNl : shall return true if the event is set in the Toolkit Registry for the applet. 

• CRRN2: shall return false if the event isn't set in the Toolkit Registry for the applet. 

5.2.8.8.1 .2 Parameter errors 
No requirements. 

5.2.8.8.1.3 Context errors 
No requirements. 

5.2.8.8.2 Test area files 

Test Source: Test_Api_2_Tkr_Ievs.java 
Test Applet: Api_2_Tkr_Ievs_l.java 

Api_2_Tkr_Ievs_2.j ava 

• Installation parameter: 

Same as default applet but with: 

■ Maximum text length for a menu entry: 15. 

■ Maximum number of menu entries: 1 . 

■ Position / Identifier for each menu entry: 'Ol'/'Ol'. 

■ Maximum number of timers: 1. 
api_2_tkr_ie vs . cap . 



Cap File: 
5.2.8.8.3 



Test coverage 



CRR number 


Test case number 


N1 


2, 3, 4, 5, 6, 7 


N2 


1,4,5,6,7,8,9 
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5.2.8.8.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Install Appletl only registered to 

EVENT UNRECOGNIZED ENVELOPE and 

EVENT_MENU_SELECTION 








Test that events aren't set 


Shall return false each time. 






Applet calls isEventSetO method for each event 








ranging from (-1, 1, 7 to 9, 11 to 23, 25 to 29, 








123, 124, 126 and 127)* excepted 








EVENT_UNRECOGNIZED_ENVELOPE (-1) and 








EVENT_MENU_SELECTI0N(7) . 






2 


For 








EVENT_UNRECOGNIZED_ENVELOPE 


Shall return true. 






Call isEventSet (EVENT UNRECOGNIZED ENVELOPE) 






3 


For EVENT_MENU_SELECTION 

Call isEventSet (EVENT_MENU_SELECTION) 


Shall return true 




4 


After clearing EVENT UNRECOGNIZED ENVELOPE 










1 - No exception shall be thrown. 






1- Call clearEvent (EVENT_UNRECOGNIZED_ENVELOPE) 


2- Shall return false. 






2- Call isEventSet (EVENT_UNRECOGNIZED_ENVELOPE) 






5 


Setting events 

For all allowed events defined in ETSI TS 102 

241 [13] for setEvent method: 

EVENT_PROF I LE_DOWNLOAD , 

EVENT_CALL_CONTROL_BY_NAA, 

EVENT_EVENT_DOWNLOAD_MT_CALL , 

EVENT_EVENT_DOWNLOAD_CALL_CONNECTED, 

EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED, 

EVENT_EVENT_DOWNLOAD_LOCATION_STATUS, 

EVENT_EVENT_DOWNLOAD_USER_ACTIVITY, 

EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE, 

EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS, 

EVENT_EVENT_DOWNLOAD_LANGUAGE_SELECTION, 

EVENT_EVENT_DOWNLOAD_BROWSER_TERMINATION, 

EVENT_EVENT_DOWNLOAD_DATA_AVAILABLE, 

EVENT_EVENT_DOWNLOAD_CHANNEL_STATUS, 

EVENT_EVENT_DOWNLOAD_ACCESS_TECHNOL0GY_CHANGE, 

EVENT_EVENT_DOWNLOAD_DISPLAY_PARAMETERS_CHANGED, 

EVENT_EVENT_DOWNLOAD_NETWORK_SEARCH_MODE_CHANGE, 

EVENT_EVENT_DOWNLOAD_BROWSING_STATUS, 

EVENT_PROACTIVE_HANDLER_AVAILABLE, 

EVENT_APPLICATION_DESELECT, 

EVENT_FIRST_COMMAND_AFTER_ATR, 

EVENT_UNRECOGNI ZED_ENVELOPE 

applet calls: 








1- Call setEvent method 


1- No exception shall be thrown. 






2- Call isEventSet {) method 


2- Shall return true each time. 




6 


ForEVENT_MENU_SELECTION_HELP_REQUEST 








1- Call 


1- Shall return false. 






isEventSet (EVENT_MENU_SELECTION_HELP_REQUEST) 








2- Call changeMenuEntry ( ) with help supported 








3- Call 

isEventSet (EVENT_MENU_SELECTION_HELP_REQUEST) 


2- Shall return true. 




7 


For EVENT_TIMER_EXPIRATION 








1- Call isEventSet (EVENT_TIMER_EXPIRATION) 


1- Shall return false. 






2- Call allocateTimer 

3- Call isEventSet (EVENT_TIMER_EXPIRATION) 


3- Shall return true. 





ETSI 



Release 6 



339 



ETSI TS 102 268 V6.0.0 (2007-03) 



8 


For EVENT_STATUS_COMMAND 

Call isEventSet (EVENT_STATUS_COMMAND) 

Call requestPollInterval (POLL_SYSTEM_DURATION) 

Call IsEventSet (EVENT_STATUS_COMMAND) 


1- Shall return false. 
3- Shall return true. 




9 


For 
EVENT_EVENT_DOWNLOAD_LOCAL_CONNECTION 

1- Call IsEventSet 

( EVENT_EVENT_DOWNLOAD_LOCAL_CONNECT I ON ) 

2- Call allocateServiceldentif ier ( ) 

3- Call IsEventSet 

( EVENT_EVENT_DOWNLOAD_LOCAL_CONNECT I ON ) 


1- Shall return false. 
3- Shall return true. 




10 


Install Applet2 only registered to 
EVENT_MENU_SELECTION 

Call IsEventSet (EVENT_UNRECOGNIZED_ENVELOPE) 


Shall return false. 





NOTE: Although the method isEventSet() is defined for a large range only the allowed events are tested, because 
a range is reserved for propriatary use in TS 102 241 [13], clause 4, and a range is omitted for 
compatibility with future releases of TS 102 241 [13]. 

5.2.8.9 Method releaseTimer 

Test Area Reference: Api_2_Tkr_Rtim. 

5.2.8.9.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public void releaseTimer (byte timerldentif ier ) 
throws ToolkitException 

5.2.8.9.1.1 Normal execution 

• CRRNl: Release a Timer that has been allocated to the calling applet. 

• CRRN2: After invocation of the method the indicated timer shall be released and available for reallocation. 

• CRRN3: The applet is deregistered of the EVENT_TIMER_EXPIRATION for the indicated Timer Identifier. 

5.2.8.9.1 .2 Parameter errors 

• CRRP 1 : shall throw a ToolkitException with INV ALID_TIMER_ID reason if the timer identifier isn't 
between 1 and 8. 



5.2.8.9.1.3 



Context errors 



• CRRC 1 : shall throw a ToolkitException with INV ALID_TIMER_ID reason if the timer is not allocated to this 
applet. 

5.2.8.9.2 Test area files 

Test Source: Test_Api_2_Tkr_Rtim.java. 
Test Applet: Api_2_Tkr_Rtim_l.java. 

Cap File: api_2_tkr_rtim.cap. 

• Installation parameter: 

As Default, except max timer which is set to 8. 
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5.2.8.9.3 



Test coverage 



CRR number 


Test case number 


N1 


2, 3,4 


N2 


5,6 


N3 


7 


N4 


7 


P1 


1,3 


C1 


CAT Runtime Environment, Cre Pes Pcco 



5.2.8.9.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Release not allocated timers 

For each timer ID ranging from '00' to 
'FF', applet calls releaseTimer (ID) 


Each time, method shall throw a 
ToolkitException with reason code 
INVALID_TIMER_ID. 




2 


Release allocated timers 

1- Call 8 times allocatelimer ( ) 

2- Call 7 times releaseTimer (id) 

3- Call isEventSet (EVENT_TIMER_EXPIRATION) 


1 - No exception shall be thrown. 

2- Each time, no exception shall be 
thrown. 

3- Shall return true 




3 


Release invalid timer ID 

1- Call releaseTimer ( 'FF' ) method 

2- Call isEventSet (EVENT_TIMER_EXPIRATION) 


1 - Shall throw a ToolkitException 
with INVALID_TIMER_ID reason 
code. 

2- Shall return true. 




4 


Release last timer 

1- Call releaseTimer (last timer allocated) 

2- Call IsEventSet (EVENT_TIMER_EXPIRATION) 


1 - No exception shall be thrown. 
2- Shall return false. 




5 


Check we can allocate timers after they have 
been released 

Call 8 times allocatelimer () method 


No exception shall be thrown. 




6 


Release all timers 

For 1 to 8, Call releaseTimer (id) 


No exception shall be thrown. 




7 


Check applet is not triggered by 

envelope(EVENT_TIMER_EXPIRATION) 

command 

Send envelope (EVENT_TIMER_EXPIRATION) 


Applet is not triggered by any 
envelope{EVENT_TIMER_EXPIRA 
TION) command 





5.2.8.10 Method requestPolllnterval 

Test Area Reference: Api_2_Tkr_Rpol. 
5.2.8.10.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void requestPolllnterval (short duration) 

throws ToolkitException 
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5.2.8.10.1.1 



Normal execution 



• CRRNl : If duration is between 1 and 15300 or equal to P0LL_SYSTEM_DURAT10N, the applet registers to 
EVENT_STATUS_COMMAND. 

• CRRN2: If duration is POLL_NO_DURATION, the applet is deregistered from 
EVENT STATUS COMMAND. 



5.2.8.10.1.2 



Parameter errors 



CRRPl: the method should throw a ToolkitException with REGlSTRY_ERROR reason if duration is > 15300 
or is < -1 (P0LL_SYSTEM_DURAT10N). 



5.2.8.10.1.3 
No requirements. 

5.2.8.10.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.8.10.3 



Context errors 
Test area files 

Test_Api_2_Tkr_Rpol.java. 
Api_2_Tkr_Rpol_ 1 .j ava. 
api_2_tkr_rpol.cap. 

Test coverage 



CRR number 


Test case number 


N1 


1,2,3,4 


N2 


6,7 


PI 


5 



5.2.8.10.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Request a value between 1 and 1 5300 s 

1- Call isEventSet (EVENT_STATUS_COMMMAND) 

2- Call requestPollInterval (duration) for 
boundaries values: 1, 255, 256, 15300. 

3- Call isEventSet (EVENT_STATUS_COMMAND) . 


1- Shall return false. 

2- No exception shall be thrown. 

3- Shall return true. 




2 


Check Applet is triggered by a STATUS 
command 

1- reset and card initialization 

2- Send STATUS command 


2- Applet is triggered by a STATUS 
command 




3 


Request POLL SYSTEM DURATION 

1- Call IsEventSet (EVENT_STATUS_COMMMAND) . 

2- Call 

RequestPollInterval (POLL_SYSTEM_DURATION) . 

3- Call IsEventSet (EVENT_STATUS_COMMAND) . 


1- Shall return true. 

2- No exception shall be thrown. 

3- Shall return true. 




4 


Check Applet is triggered by a STATUS 
command 

1- reset and card initialization 

2- Send STATUS command 


2- Applet is triggered by a STATUS 
command 
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5 


Request invalid duration 

Call requestPollInterval (duration) for 
following values: 15301, 32767, -2, -32768 


Each time, a ToolkitException with 
REGISTRY_ERROR reason code, 
shall be thrown. 




6 


Request POLL NO DURATION 

1- Call isEventSet (EVENT_STATUS_COMMMAND) 

2- Call 

requestPollInterval (POLL_NO_DURATION) 

3- Call isEventSet (EVENT_STATUS_COMMAND) 


1- Shall return true. 

2- No exception shall be thrown. 

3- Shall return false. 




7 


Check Applet is not triggered by an STATUS 
command. 

1- reset and card initialization 

2- Send STATUS command 


2- Applet is not triggered by a 
STATUS command 





5.2.8.11 Method setEvent 

Test Area Reference: Api_2_Tkr_Sevt 

5.2.8.1 1.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void setEvent (short id) 

throws ToolkitException, 

javacard. framework .TransactionException 



5.2 



5.2 



8.11.1.1 Normal execution 

CRRNl: A following call to isEventSet() method with the same event id shall answer true for the applet. 

CRRN2: The CAT Runtime Environment shall trigger the applet if an occurrence of the set event happens. 

CRRN3: the method shall accept all the events defined in TS 102 241 [13] except: 
EVENT_MENU_SELECTION, EVENT_MENU_SELECTION_HELP_REQUEST, 
EVENT_T1MER_EXP1RATI0N, EVENT_STATUS_COMMAND, 
EVENT_EVENT_DOWNLOAD_LOCAL_CONNECTIONandEVENT_EXTERNAL_FILE_UPDATE. 

CRRN4: no exception shall be thrown if the applet registers more than once to the same event. 

CRRN5: all updates in the ToolkitRegistry are atomic. 

8.11.1.2 Parameter errors 

CRRPl: shall throw a ToolkitException with EVENT_NOT_SUPPORTED reason if event is 0. 

CRRP2: shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if event is 
EVENT_MENU_SELECTION. 

CRRP3: shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if event is 
EVENT_MENU_SELECTION_HELP_REQUEST. 

CRRP4: shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if event is 
EVENT_T1MER_EXP1RAT10N. 

CRRP5: shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if event is 
EVENT_STATUS_COMMAND. 

CRRP6: shall throw a Toolkit Exception with reason EVENT_NOT_ALLOWED if event was 
EVENT_EVENT_DOWNLOAD_LOCAL_CONNECTION. 
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CRRP7: shall throw a Toolkit Exception with reason EVENT_NOT_ALLOWED if event was 
EVENT_EXTERNAL_FILE_UPDATE. 



5.2.8.11.1.3 



Context errors 



• CRRC 1 : shall throw a ToolkitException with EVENT_ALREAD Y_REGISTERED if event is 
EVENT_CALL_CONTROL_BY_NAA but another applet is already registered to it. 

• CRRC2: shall throw a ToolkitException with EVENT_ALREAD Y_REGISTERED if event is 
EVENT_CALL_CONTROL_B Y_NAA but another applet that it is not in selectable state is already registered 
to it. 

• CRRC3: shall throw javacard.framework.TransactionException - if the operation would cause the commit 
capacity to be exceeded. 

• CRRC4: shall throw a ToolkitException with TAR_NOT_DEFINED if the event requests a tag and the applet 
has no TAR defined. 

5.2.8.11.2 Test area files 

Test Source: Test_Api_2_Tkr_Sevt.java. 
Test Applet: Api_2_Tkr_Sevt_l.java. 

Api_2_Tkr_Sevt_2.java. 

Api_2_Tkr_Sevt_3 .j ava. 

Api_2_Tkr_Sevt_4.j ava. 

The load script installs the 4 instances. 
Cap File: api_2_tkr_sevt.cap. 

5.2.8.11.3 Test coverage 



CRR number 


Test case number 


N1 


2 


N2 


1, 10, 11 


N3 


2, 4, 5, 6, 7, 8, 9 


N4 


14 


N5 


not testable 


PI 


3 


P2 


4 


P3 


5 


P4 


6 


P5 


7 


P6 


8 


P7 


9 


CI 


12 


C2 


13 


C3 


not testable 


C4 


not testable 
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5.2.8.11.4 



Test procedure 



Id 


Description 


API Expectation 


APDU 
Expectation 


1 


Appletl is triggered by envelope 

(EVENT_EVENT_DOWNLOAD_USER_ACTIVITY) 

command. 








Send 


Appletl shall be triggered 






ENVELOPE (EVENT_EVENT_DOWNLOAD_USER_ACTI VI TY) 






2 


Set ALLOWED and SUPPORTED events 

1- For all allowed events (-1, 1, 7 to 9, 11 to 
23, 25 to 29, 123, 124, 126 and 127 excepted 7, 
8, 11, 19, 27, 124) defined in ETSI TS 102 241 
[]*: 

EVENT_PROF I LE_DOWNLOAD , 
EVENT_CALL_CONTROL_BY_NAA, 
EVENT_EVENT_DOWNLOAD_MT_CALL , 
EVENT_EVENT_DOWNLOAD_CALL_CONNECTED, 
EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED, 
EVENT_EVENT_DOWNLOAD_LOCATION_STATUS, 
EVENT_EVENT_DOWNLOAD_USER_ACTIVITY, 
EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE, 
EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS, 
EVENT_EVENT_DOWNLOAD_LANGUAGE_SELECTION, 
EVENT_EVENT_DOWNLOAD_BROWSER_TERMINATION, 
EVENT_EVENT_DOWNLOAD_DATA_AVAILABLE, 
EVENT_EVENT_DOWNLOAD_CHANNEL_STATUS, 
EVENT_EVENT_DOWNLOAD_ACCESS_TECHNOL0GY_CHANGE, 
EVENT_EVENT_DOWNLOAD_DISPLAY_PARAMETERS_CHANGED, 
EVENT_EVENT_DOWNLOAD_NETWORK_SEARCH_MODE_CHANGE, 
EVENT_EVENT_DOWNLOAD_BROWSING_STATUS, 
EVENT_PROACTIVE_HANDLER_AVAILABLE, 
EVENT_APPLICATION_DESELECT, 
EVENT_FIRST_COMMAND_AFTER_ATR, 
EVENT_UNRECOGNIZED_ENVELOPE 








1.1- Call clearEvent (event) 


1.1- No exception shall be 
thrown. 






1.2- Call isEventSet (event) 


1.2- Shall return false. 






1.3- Call setEvent (event) 


1 .3- No exception shall be 






1.4- Call isEventSet (event) 


thrown. 






1.5- Call clearEvent (event) 


1.4- Shall return true. 

1 .5- No exception shall be 
thrown. 




3 


Set Event 


Shall throw a ToolkitException with 






Call setEvent (0) 


EVENT_NOT_SUPPORTED reason 
code. 




4 


Set EVENT MENU SELECTION 








Call setEvent (EVENT_MENU_SELECTION) 


Shall throw a ToolkitException with 
EVENT_NOT_ALLOWED reason 
code. 




5 


Set EVENT MENU SELECTION HELP REQUEST 








Call setEvent (EVENT_MENU_SELECTION_HELP_REQUEST) 


Shall throw a ToolkitException with 
EVENT_NOT_ALLOWED reason 
code. 




6 


Set EVENT TIMER EXPIRATION 








Call setEvent (EVENT„TIMER_EXPIRATION) 


Shall throw a ToolkitException with 
EVENT_NOT_ALLOWED reason 
code. 
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Id 


Description 


API Expectation 


APDU 
Expectation 


7 


Set EVENT_STATUS_COMIVIAND 

Call setEvent (EVENT_STATUS_COMMAND) 


Shall throw a ToolkitException with 
EVENT_NOT_ALLOWED reason 
code. 




8 


Set 
EVENT_EVENT_DOWNLOAD_LOCAL_CONNECTION 

Call 

setEvent (EVENT_EVENT_DOWNLOAD_LOCAL_CONNECTION) 


Shall throw a ToolkitException with 
EVENT_NOT_ALLOWED reason 
code. 




9 


Set EVENT_EXTERNAL_FILE_UPDATE 

Call setEvent (EVENT_EXTERNAL_FILE_UPDATE) 


Shall throw a ToolkitException with 
EVENT_NOT_ALLOWED reason 
code. 




10 


Set EVENT_CALL_CONTROL_BY_NAA 

Call setEvent (EVENT_CALL_CONTROL_BY_NAA) 


No Exception shall be thrown 




11 


Check applet is triggered by envelope 
(CALL_CONTROL_BY_NAA) command 

Trigger Appletl 


Appletl is triggered by an 
ENVELOPE(CALL CONTROL BY 
NAA) 




12 


Applet2 registers to 

EVENT_CALL_CONTROL_BY_NAA but it is already 

assigned to another applet 

Applet2 call setEvent (EVENT_CALL_CONTROL_BY_NAA) 


Shall throw a ToolkitException with 
EVENT_ALREADY_REGISTERED 
reason code. 




13 


Applet3 registers to 

EVENT_CALL_CONTROL_BY_NAA 

but it is already assigned to another applet in not 

selectable state 

1- Set Appletl in the lock state 

2- Trigger Applets which calls 
setEvent (EVENT_CALL_CONTROL_BY_NAA) 

3- Set Appletl in the make selectable state 


2- Shall throw a ToolkitException 
with 

EVENT_ALREADY_REGISTERED 
reason code. 




14 


Applet4 registers multiple registration to the same 
event 

1- setEvent (EVENT_EVENT_DOWNLOAD_MT_CALL) 

2- setEvent (EVENT_EVENT_DOWNLOAD_MT_CALL) 

3- isEventSet (EVENT_EVENT_DOWNLOAD_MT_CALL) 


1- no exception should be thrown 

2- no exception should be thrown 

3- method should return true 





NOTE: Although the method setEvent is defined for large range only the allowed events are tested, because a 
range is reserved for propriatary use in TS 102 241 [13], clause 4, and a range is omitted for 
compatibility with future releases of TS 102 241 [13]. 

5.2.8.12 Method setEventList 

Test Area Reference: Api_2_Tkr_Sevl. 



5.2.8.12.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

public void setEventList (short [ ] eventList, 

short offset, 
short length) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 

ToolkitException, 

javacard. framework. Trans act ionExcept ion 
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5.2.8.12.1.1 Normal execution 

CRRN 1 : For all events set successfully by this method, sets an event list in the Toolkit Registry entry of the 
applet. 

CRRN2: The CAT Runtime Environment shall trigger the applet if an occurrence of one of the successfully 
registered events happens. 

CRRN3: All updates on the ToolkitRegistry are atomic. 

CRRN4: No exception shall be thrown if the applet registers more than once to the same event. 

5.2.8.12.1.2 Parameter errors 

CRRPl: shall throw a java.lang.NullPointerException if eventList is null. 

CRRP2: shall throw a java.lang.ArraylndexOutOfBoundsException if offset would cause access outside array 
bounds. 

CRRP3: shall throw a java.lang.ArraylndexOutOfBoundsException if length would cause access outside array 
bounds. 

CRRP4: shall throw a java.lang.ArraylndexOutOfBoundsException if both offset and length would cause 
access outside array bounds. 

CRRP5: shall throw a ToolkitException with EVENT_NOT_SUPPORTED reason if event is 0. 

CRRP6: shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if eventList contains 
EVENT_MENU_SELECTION. 

CRRP7: shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if eventList contains 
EVENT_MENU_SELECTION_HELP_REQUEST. 

CRRP8: shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if eventList contains 
EVENT_TIMER_EXPIRATION. 

CRRP9: shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if eventList contains 
EVENT_STATUS_COMMAND. 

CRRPIO: Shall throw a Toolkit Exception with reason EVENT_NOT_ALLOWED if event was 
EVENT_EVENT_DOWNLOAD_LOCAL_CONNECTION. 

CRRP 1 1 : Shall throw a Toolkit Exception with reason EVENT_NOT_ALLOWED if event was 
EVENT_EXTERNAL_FILE_UPDATE. 

5.2.8.12.1.3 Context errors 

CRRCl: shall throw a ToolkitException with EVENT_ALREADY_REGISTERED if eventList contains 
EVENT_CALL_CONTROL_BY_NAA but another applet is already registered to it. 

CRRC2: shall throw javacard.framework.TransactionException - if the operation would cause the commit 
capacity to be exceeded. 

CRRC3: shall throw a ToolkitException with TAR_NOT_DEFINED if the eventList contains an event that 
requests a tag and the applet has not at least one TAR value assigned. 

5.2.8.12.2 Test area files 

Test Source: Test_Api_2_Tkr_Sevl.java. 
Test Applet: Api_2_Tkr_Sevl_Ljava. 

Api_2_Tkr_Sevl_2.java. 
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Cap File: 
5.2.8.12.3 



api_2_tkr_sevl. cap . 



Test coverage 



CRR number 


Test case number 


N1 


1,2 


N2 


18,19 






N3 


21 


N4 


22 


P1 


3 


P2 


4,5,6 


P3 


7,8,9 


P4 


10 


P5 


11 


P6 


12 


P7 


13 


P8 


14 


P9 


15 


P10 


16 


P11 


17 


C1 


20 


C2 


not testable 


C3 


not testable 
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5.2.8.12.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Appletl registering all eventList buffer 

Appletl is triggered by an 

envelope (MENU_SELECTION) (Id = 01) 

EventList = all allowed events (-1, 1, 7 to 9, 11 

to 23, 25 to 29, 123, 124, 126 and 127 excepted 

7, 8, 11, 19, 27, 124) defined in ETSI TS 102 

241[13] : 

EVENT_PROF I LE_DOWNLOAD , 

EVENT_CALL_CONTROL_BY_NAA, 

EVENT_EVENT_DOWNLOAD_MT_CALL, 

EVENT_EVENT_DOWNLOAD_CALL_CONNECTED, 

EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED, 

EVENT_EVENT_DOWNLOAD_LOCATION_STATUS, 

EVENT_EVENT_DOWNLOAD_USER_ACTIVITY, 

EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE, 

EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS, 

EVENT_EVENT_DOWNLOAD_LANGUAGE_SELECTION, 

EVENT_EVENT_DOWNLOAD_BROWSER_TERMINATION, 

EVENT_EVENT_DOWNLOAD_DATA_AVAILABLE, 

EVENT_EVENT_DOWNLOAD_CHANNEL_STATUS, 

EVENT_EVENT_DOWNLOAD_ACCESS_TECHNOL0GY_CHANGE, 

EVENT_EVENT_DOWNLOAD_DISPLAY_PARAMETERS_CHANGED, 

EVENT_EVENT_DOWNLOAD_NETWORK_SEARCH_MODE_CHANGE, 

EVENT_EVENT_DOWNLOAD_BROWSING_STATUS, 

EVENT_PROACTIVE_HANDLER_AVAILABLE, 

EVENT_APPLICATION_DESELECT, 

EVENT_FIRST_COMMAND_AFTER_ATR, 

EVENT_UNRECOGNIZED_ENVELOPE 










1- No exception shall be 






1- For each event in EventList, clearEvent (event ) 


thrown. 






2- Call setEventList (eventList) 


2- No exception shall be 






Offset = 


thrown. 






Length = eventList . length 


3- Each time shall return true. 






3- For all events in eventList, isEventSet (event ) 








4- For each event in EventList, clearEvent (event ) 


4- No exception shall be 
thrown. 




2 


Registering part of eventList buffer 








EventList = all allowed events defined in ETSI TS 


1- No exception shall be 






102 241[13] (see test case 1). 


thrown. 

2- Each time shall return true 






1- setEventList (eventList, offset, length) 

Offset > 

Length = eventList . lentgh - offset 


for events ranging from offset 
to offset+length else shall 
return false. 






2- For all events in eventList: 








Call isEventSet (event) 


3- No exception shall be 
thrown. 






3- For each event in EventList: clearEvent (event ) 






3 


Null buffer 


Shall throw a 






setEventList () 


java.lang.NullPointerException 






EventList = null 


Exception 




4 


Out of bounds offset 


Shall throw a 






setEventList ( ) 

Offset = eventList . length 


java.lang.ArraylndexOutOfBou 






Length = 1 


nds Exception 
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Id 


Description 


API Expectation 


APDU Expectation 


5 


Out of bounds and big offset 

setEventList ( ) 
Offset = 255 
Length = 1 


Shall throw a 

java.lang.ArraylndexOutOfBou 
nds Exception 




6 


Offset < 

setEventList ( ) 
Offset = -1 
Length = 1 


Shall throw a 

Java.lang.ArraylndexOutOfBou 
nds Exception 




7 


Out of bounds length 

setEventList ( ) 

Offset = 

Length = eventList . length + 1 


Shall throw a 

Java.lang.ArraylndexOutOfBou 
nds Exception 




8 


Out of bounds and big length 

setEventList ( ) 
Offset = 
Length = 255 


Shall throw a 

Java.lang.ArraylndexOutOfBou 
nds Exception 




9 


Length < 

setEventList () 
Offset = 
Length = -1 


Shall throw a 

Java.lang.ArraylndexOutOfBou 
nds Exception 




10 


Out of bounds offset + Length 

setEventList () 

Offset + length > eventList . length + 1 


Shall throw a 

Java.lang.ArraylndexOutOfBou 
nds Exception 




11 


Event 

Call setEventList (eventList ) with eventList 
indicating event 


Shall throw a ToolkitException 
with 

EVENT_NOT_SUPPORTED 
reason code. 




12 


EVENT_MENU_SELECTION 

Call setEventList (eventList ) with eventList 
indicating EVENT_MENU_SELECTION 


Shall throw a ToolkitException 
with reason code 
EVENT_NOT_ALLOWED. 




13 


EVENT_MENU_SELECTION_HELP_REQUEST 

Call setEventList (eventList ) with eventList 
indicating EVENT_MENU_SELECTION_HELP_REQUEST 


Shall throw a ToolkitException 
with reason code 
EVENT_NOT_ALLOWED. 




14 


EVENT_TIMER_EXPIRATION 

Call setEventList (eventList ) with eventList 
indicating EVENT_TIMER_EXPIRATION 


Shall throw a ToolkitException 
with reason code 
EVENT NOT ALLOWED. 




15 


EVENT_STATUS_COMMAND 

Call setEventList (eventList ) with eventList 
indicating EVENT_STATUS_COMMAND 


Shall throw a ToolkitException 
with reason code 
EVENT NOT ALLOWED. 




16 


EVENT_EVENT_DOWNLOAD_LOCAL_CONNECTION 

Call setEventList (eventList ) with eventList 
indicating EVENT_EVENT_DOWNLOAD_LOCAL„CONNECTION 


Shall throw a ToolkitException 
with reason code 
EVENT_NOT_ALLOWED. 




17 


EVENT_EXTERNAL_FILE_UPDATE 

Call setEventList (eventList ) with eventList 
indicating EVENT_EXTERNAL_FILE_UPDATE 


Shall throw a ToolkitException 
with reason code 
EVENT_NOT_ALLOWED. 
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Id 


Description 


API Expectation 


APDU Expectation 


18 


Sett EVENT_CALL_CONTROL_BY_NAA 

Call setEventList (MonoEventList, 0, 1) with 
MonoEventList containing 
EVENT_CALL_CONTROL_BY_NAA 


Shall not throw an exception. 




19 


Check applet Is triggered by an ENVELOPE 
(CALL_CONTROL_BY_NAA) 

Reset and initialize the card 
Trigger Appletl 


Applet is triggered by an 
ENVELOPE(CALL CONTROL 
_BY_NAA) 




20 


Applet2 registers to CALL_CONTROL_BY_NAA 
but It is already assigned 

Applet2 is triggered by an 

envelope (MENU_SELECTION) (Id=02) 

1- Call setEventList (MonoEventList, 0, 1) with 

MonoEventList containing 

EVENT_CALL_CONTROL_BY_NAA 


1- Shall throw a 
ToolkitException with 
EVENT_ALREADY_REGISTE 
RED reason code. 




21 


Atomicity 

1- Call setEventList (EVENT_CALL_CONTROL_BY_NAA, 
EVENT_EVENT_DOWNLOAD_CALL_CONNECTED) 

2- isEventSet 
(EVENT_EVENT_DOWNLOAD_CALL_CONNECTED) 


1- Shall throw a 
ToolkitException with 
EVENT_ALREADY_REGISTE 
RED reason code. 

2- method shallreturn false 




22 


Multiple registration to the same event 

1- setEventList (EVENT_EVENT_DOWNLOAD_MT_CALL, 
EVENT_EVENT_DOWNLOAD_MT_CALL ) 

2- isEventSet (EVENT_EVENT_DOWNLOAD_MT_CALL) 


1- no exception should be 
thrown 

2- method shall return true 





5.2.8.13 Method allocateServiceldentifier 

Test Area Reference: Api_2_Tkr_Asid. 

5.2.8.13.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte allocateServiceldentif ier ( ) 

throws ToolkitException, 

javacard. framework .TransactionException 

5.2.8.13.1.1 Normal execution 

CRRNl: The returned service identifier shall be between 00 and 07 inclusive. 

CRRN2: The returned service identifier shall be different from a previously allocated but not released one. 

CRRN3: By calling this method the applet is registered to the EVENT_EVENT_ 
DOWNLOAD_LOCAL_CONNECTION of the allocated service. 

CRRN4: The service identifier is allocated by the applet until it explicitly releases it. 

CRRN5: When an applet allocates a service identifier, it can issue the proactive command DECLARE 
SERVICE to add or delete a service to the terminal service database. 
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5.2.8.13.1.2 
No requirements. 

5.2.8.13.1.3 



Parameter errors 



Context errors 



• CRRCl : Shall throw a ToolkitException with reason NO_SERVICE_ID_AVAILABLE if all the services are 
allocated. 

• CRRC2: Shall throw a ToolkitException with reason NO_SERVICE_ID_AVAILABLE if the maximum 
number of services Identifiers have been allocated to this applet according to installation parameter. 



5.2.8.13.2 

Test Source: 
Test Applet: 



Cap File: 
5.2.8.13.3 



Test area files 

Test_Api_2_Tkr_Asid.j ava. 
Api_2_Tkr_Asid_l.java: 8 services. 
Api_2_Tkr_Asid_2.java: 4 services. 
Api_2_Tkr_Asid_3.java: services. 
api_2_tkr_asid.cap. 

Test coverage 



CRR number 


Test case number 


N1 


1 


N2 


1 


N3 


2 


N4 


2 


N5 


Cat Runtime Environment, 
Cre Pes Pcco 


CI 


3 


C2 


4 



5.2.8.13.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Allocates up to 8 services 
(Appletl) 

Appletl is triggered by an 

envelope (EVENT_MENU_SELECTION) with Item = 01. 

Call 8 times: 

- allocateServiceldentif ier ( ) 

- send associated DECLARE SERVICE 

- isEventSet 
(EVENT_EVENT_DOWNLOAD_LOCAL_CONNECTION) . 


No exception shall be thrown. 
Service ID returned shall be 
between 00 and 07 inclusive. It 
shall be different after each call. 
Shall return true. 




2 


Check Appletl is triggered by envelope 

(EVENT_EVENT_DOWNLOAD_LOCAL_CONNECTI 

ON) command 

1- Send 8 envelopes 

(EVENT_EVENT_DOWNLOAD_LOCAL_CONNECTION) with 
all services id (not in an increase order) . 

2- Call releaseServiceldentif ier (id) with all 
services . 

3- Call isEventSet 
(EVENT_EVENT_DOWNLOAD_LOCAL_CONNECTION) method 


1- Appletl shall be triggered each 
time. 

3- returns false. 
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Id 


Description 


API Expectation 


APDU Expectation 


3 


Allocate services more than the maximum 

Appletl is triggered by an 

envelope (EVENT_MENU_SELECTION) with Item = 01. 

1- Appletl calls 5 times 
allocateServiceldentif ier ( ) method 

Applet2 is triggered by an 

envelope (EVENT_MENU_SELECTION) with Item = 02 

2- Applet2 calls 3 times 
allocateServiceldentif ier ( ) method 

3- Applet2 calls 1 more 
allocateServiceldentif ier ( ) method 
Appletl is triggered by an 

envelope (EVENT_MENU_SELECTION) with Item = 01. 

4- Appletl releases all its services. 


1- No exception shall be thrown. 
Each time, the returned service 
identifier shall be between '00' and 
'07' inclusive. It shall be different 
after each call. 

Appletl finalizes. 

2- No exception shall be thrown. 
Each time, the returned service 
identifier shall be between '00' and 
'07' inclusive. It shall be different 
after each call it shall be different 
from the ones allocated to 
Appletl . 

3- A ToolkitException with reason 
NO_SERVICE_ID_AVAILABLE 
shall be thrown 

Applet2 finalizes. 

4- No exception is thrown. 
Appletl finalizes. 




4 


Allocate services more than the maximum to this 

applet 

(Applet3 and Applet2) 

Applet3 is triggered by an 

envelope (EVENT_MENU_SELECTION) with Item = 03 

1- Applet3 calls allocateServiceldentif ier ( ) 
method. 

Applet2 is triggered by an 

envelope (EVENT_MENU_SELECTION) with Item = 02 

2- Applet2 calls allocateServiceldentif ier ( ) 
method 

3- Applet2 calls allocateServiceldentif ier ( ) 
again 


1- A ToolkitException with reason 
NO_SERVICE_ID_AVAILABLE 
shall be thrown 

Applet3 finalizes. 

2- No exception shall be thrown. 

3- A ToolkitException with reason 
NO_SERVICE_ID_AVAILABLE 
shall be thrown 





5.2.8.14 Method releaseServiceldentifier 

Test Area Reference: Api_2_Tkr_Rsid. 

5.2.8.14.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void releaseServiceldentifier (byte serviceldentif ier) 

throws ToolkitException, 

javacard. framework .TransactionException 

5.2.8.14.1.1 Normal execution 

• CRRNl: Release a Service Identifier that has been allocated to the calling applet. 

• CRRN2: The applet is deregistered of EVENT_EVENT_DOWNLOAD_LOCAL_CONNECTION for the 
indicated service identifier. 
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5.2.8.14.1.2 



Parameter errors 



• CRRP 1 : shall throw a TooMtException with INV ALID_SERVICE_ID reason if the service identifier is not 
between and 7. 



5.2.8.14.1.3 



Context errors 



CRRCl: shall throw a TooMtException with INVALID_SERVICE_ID reason if the service is not allocated to 
this applet. 



5.2.8.14.2 

Test Source: 
Test Applet: 

Cap File: 
5.2.8.14.3 



Test area files 

Test_Api_2_Tkr_Rsid.j ava. 
Api_2_Tkr_Rsid_l.java: 8 services. 
Api_2_Tkr_Rsid_2.java: 1 service. 
api_2_tkr_rsid.cap. 

Test coverage 



CRR number 


Test case number 


N1 


4,5,6 


N2 


2, 3, 4, 7 


PI 


1,3 


CI 


8 



5.2.8.14.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Release not allocated services 








Appletl is triggered by 

envelope (EVENT_MENU_SELECTION) with Item = 

1 

For each service ID ranging from '00' to 

' FF ' , applet calls 

releaseServiceldentif ier (ID) . 


Each time, method shall throw a 
ToolkitException with reason code 
INVALID_SERVICE_ID. 




2 


Release allocated services 








1- Call 8 times 
allocateServiceldentif ier () method. 


1- No exception shall be thrown. 






2- Call 7 times 

releaseServiceldentif ier (id) method with 

id from to 6 . 


2- Each time, no exception shall be 
thrown. 






3- Call 

isEventSet (EVENT_EVENT_DOWNLOAD_LOCAL_CONN 

ECTION) 


3- Shall return true 




3 


Release invalid service ID 








1- Call releaseServiceldentif ier ( 'FF' ) 
method 

2- Call 

isEventSet (EVENT_EVENT_DOWNLOAD_LOCAL_CONN 
ECTION) method 


1- Shall throw a ToolkitException 
with INVALID_SERVICE_ID reason 
code. 

2- Shall return true. 
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Id 


Description 


API Expectation 


APDU Expectation 


4 


Release last service 

1- Call releaseServiceldentif ier ( ) method 
with id = '07' 

2- Call 

isEventSet (EVENT_EVENT_DOWNLOAD_LOCAL_CONN 
ECTION) 


1- No exception shall be thrown. 

2- Shall return false. 




5 


Released services can be allocated 

1- Appletl calls 8 times 
allocateServiceldentif ier () method. 

2- Appletl calls 

releaseServiceldentif ier method with the 
service Id = 1 

Applet2 is triggered by 

envelope (EVENT_MENU_SELECTION) with Item = 

2 

3- Applet2 calls 
allocateServiceldentif ier () method. 


1- No exception shall be thrown. 

2- No exception shall be thrown. 
Appletl finalizes 

3- No exception shall be thrown, 
the service Id allocated shall be 1 




6 


Release all services 

Appletl is triggered by 

envelope (EVENT_MENU_SELECTION) with Item = 

1 

Appletl calls releaseServiceldentif ier (id) 

method for id and 2 to 7 . 


No exception shall be thrown. 
Appletl finalizes. 




7 


Check Appletl is not triggered by 

envelope(EVENT EVENT DOWNLOAD LOCAL 

_CONNECTION) command 

Send 

envelope (EVENT_EVENT_DOWNLOAD_LOCAL_CONNEC 

HON) 


Appletl is not triggered by an 
ENVELOPE(EVENT EVENT DO 
WNLOAD_LOCAL_CONNECTION) 
command. 
Applet2 is triggered. 




8 


Release invalid service ID 

Appletl is triggered by 

envelope (EVENT_MENU_SELECTION) with Item = 

1 

1- Appletl calls 

allocateServiceldentif ier ( ) method 7 
times . 

2- Appletl calls 

releaseServiceldentif ier method with id 
= '01' . 


1- No exception shall be thrown, 
the services Id shall be different 
from 01 

2- Shall throw a ToolkitException 
with INVALID_SERVICE_ID reason 
code. 
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5.2.8.15 Method registerFileEvent(short event, byteQ baFileList, short sOffsetl , short 
sLengthI , byteQ baADFAid, short sOffset2, byte bLength2) 

Test Area Reference: Api_2_Tkr_Rgfes_Bss_Bsb. 

5.2.8.15.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void registerFileEvent (short event, 

byte[] baFileList, 
short sOffsetl, 
short sLengthl, 
byte[] baADFAid, 
short sOffset2, 
byte bLength2) 
throws ToolkitException, 

Java . lang . NullPointerException, 
Java .lang . ArraylndexOutOfBoundsException, 
javacard. framework .TransactionException, 
javacard. framework . SystemException 

5.2.8.15.1.1 Normal execution 

CRRNl: The only event allowed and supported by the method is EVENT_EXTERNAL_FILE_UPDATE. 

CRRN2: The CAT Runtime Environment shall trigger the applet when a elementary file included in the 
baFileList is updated. 

CRRN3: If the path provided indicates a dedicated file (DF), the Applet shall be triggered when an elementary 
file within this dedicated file is updated. 

CRRN4: The baADFAid indicates the Aid of the ADF under which the file is located. 

CRRN5: If baADFAid is null, it indicates that the file is located under the MF and not located under an ADF. 

CRRN6: A call to isEventSet() method for EVENT_EXTERNAL_FILE_UPDATE should return true if the 
registerFileEventO method has been successfully called. 



5.2 



8.15.1.2 Parameter errors 

CRRPl: Shall throw a Java. lang. NullPointerException if baFileList is null. 

CRRP2: Shall throw a Java. lang. ArraylndexOutOfBoundsException if sOffsetl or sLengthl or both would 
cause access outside array bounds. 

CRRP3: Shall throw a Java. lang. ArraylndexOutOfBoundsException if sOffset2 or sLength2 or both would 
cause access outside array bounds. 

CRRP4: Shall throw a javacard.framework.TransactionException if the operation would cause the commit 
capacity to be exceeded. 

CRRP5: Shall throw a javacard.framework.SystemException with ILLEGAL_VALUE reason if bLength2 is 
not in the range of 5 bytes to 16 bytes. 

CRRP6: Shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if the event is 
EVENT_MENU_SELECTION. 

CRRP7: Shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if the event is 
EVENT_MENU_SELECTION_HELP_REQUEST. 

CRRP8: Shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if the event is 
EVENT_TIMER_EXPIRATION. 

CRRP9: Shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if the event is 
EVENT STATUS COMMAND. 
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CRRPIO: Shall throw a ToolkitException with EVENT_NOT_SUPPORTED reason if the event is not 
EVENT_EXTERNAL_FILE_UPDATE. 



5.2.8.15.1.3 
No requirements. 

5.2.8.15.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.8.15.3 



Context errors 
Test area files 

Test_Api_2_Tkr_Rgfes_Bss_Bsb.java. 
Api_2_Tkr_Rgfes_B s s_B sb_ 1 .j ava. 
api_2_tkr_rgfes_bss_bsb.cap. 

Test coverage 



CRR number 


Test case number 


N1 


1,2,3,4 


N2 


1,3,21,22,23,24 


N3 


2,4 


N4 


3,4 


N5 


1,2 


N6 


1 


P1 


5 


P2 


6,7,8,9, 10 


P3 


11,12,13,14 


P4 


Not testable 


P5 


15 


P6 


16 


P7 


17 


P8 


18 


P9 


19 


P10 


20 



ETSI 



Release 6 



357 



ETSI TS 102 268 V6.0.0 (2007-03) 



5.2.8.15.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Register EF under IMF 

1- Call isEventSet 
(EVENT_EXTERNAL_FILE_UPDATE) method 

2- Call registerFileEvent method with 
parameters : 

event= EVENT_EXTERNAL_FILE_UPDATE 
baFileList="02 3F0011116F03 3F001111 6F09" 
baADFAid=null 

3- Call IsEventSet 
(EVENT_EXTERNAL_FILE_UPDATE) method 

4- Update binary on MF\DFTEST\EFTARU 

5- Increase on MF\DFTEST\EFCARU 

6- Update record on MF\DFTEST\EFLARU 

7- Update binary on MF\DFTEST\ 
DFSUB_TEST\EFTAA 

8- Call deregisterFileEvent method with 
parameters : 

event= EVENT_EXTERNAL_FILE_UPDATE 
baFileList="02 3F0011116F03 3F0011116F09" 
baADFAid=null 


1- Returns false 

2- No exception Is thrown 

3- Returns true 

4- Applet Is triggered 

5- Applet Is triggered 

6- Applet Is not triggered 

7- Applet Is not triggered 




2 


Register DF under MF 

1- Call registerFileEvent method with 
parameters : 

event= EVENT_EXTERNAL_FILE_UPDATE 
baFileList="01 3F001111" 
baADFAid=null 

2- Update binary on MF\DFTEST\EFTARU 

3- Increase on MF\DFTEST\EFCARU 

4- Update record on MF\DFTEST\EFLARU 

5- Update binary on MF\DFTEST\ 
DFSUB_TEST\EFTAA 

6- Call deregisterFileEvent ( ) method with 
parameters : 

event= EVENT_EXTERNAL_FILE„UPDATE 
baFileList="01 3F001111" 
baADFAid=null 


1- No exception is thrown 

2- Applet is triggered 

3- Applet is triggered 

4- Applet Is triggered 

5- Applet is not triggered 
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Id 


Description 


API Expectation 


APDU Expectation 


3 


Register EF under ADF1 

1- Call registerFileEvent ( ) method with 
parameters : 

event= EVENT_EXTERNAL_FILE_UPDATE 
baFileList="02 3F007FFF11116F03 
3F007FFF11116F09" 
baADFAid="AID ADFl" 

2- Update binary on ADF1\DFTEST\EFTARU 

3- Increase on ADF1\DFTEST\EFCARU 

4- Update record on ADF1\DFTEST\EFLARU 

5- Update binary on ADF1\DFTEST\ 
DFSUB_TEST\EFTAA 

6- Call deregisterFileEvent method with 
parameters : 

event= EVENT_EXTERNAL_FILE_UPDATE 
baFileList="02 3F007FFF11116F03 
3F007FFF11116F09" 
baADFAid="AID ADFl" 


1- No exception is thrown 

2- Applet is triggered 

3- Applet is triggered 

4- Applet is not triggered 

5- Applet is not triggered 




4 


Register DP under ADF1 

1- Call registerFileEvent ( ) method with 
parameters : 

event= EVENT_EXTERNAL_FILE_UPDATE 
baFileList="01 3F007FFF1111" 
baADFAid="AID ADFl" 

2- Update binary on ADF1\DFTEST\EFTARU 

3- Increase on ADF1\DFTEST\EFCARU 

4- Update record on ADF1\DFTEST\EFLARU 

5- Update binary on ADF1\DFTEST\ 
DFSUB_TEST\EFTAA 

6- Call deregisterFileEvent ( ) method with 
parameters : 

event= EVENT_EXTERNAL_FILE_UPDATE 
baFileList="01 3F007FFF1111" 
baADFAid="AID ADFl" 


1- No exception is thrown 

2- Applet is triggered 

3- Applet is triggered 

4- Applet is triggered 

5- Applet is not triggered 

6- No exception is thrown 




5 


NullPointerException Exception 

Call registerFileEvent ( ) method with null 
baFileList 


Shall throw a NullPointerException 




6 


sOffsetl >= baFileList.length 

Call registerFileEvent ( ) method with 
baFileList.length = 8 
sOffsetl = 8 
sLengthl = 4 


Shall throw a 
ArraylndexOutOfBoundsException 




7 


sOffsetl < 

Call registerFileEvent ( ) method with 
baFileList.length = 8 
sOffsetl = -1 
sLengthl = 4 


Shall throw a 
ArraylndexOutOfBoundsException 





ETSI 



Release 6 



359 



ETSI TS 102 268 V6.0.0 (2007-03) 



Id 


Description 


API Expectation 


APDU Expectation 


8 


sLengthI > baFlleLlst.length 

Call registerFileEvent ( ) method with 
baFlleLlst.length = 8 
sOffsetl = 
sLengthl = 10 


Shall throw a 
ArraylndexOutOfBoundsException 




9 


sOffsetl + sLengthl > baFlleLlst.length 

Call registerFileEvent ( ) method with 
baFlleLlst.length = 8 
sOffsetl = 5 
sLengthl = 4 


Shall throw a 
ArraylndexOutOfBoundsException 




10 


sLengthl < 

Call registerFileEvent ( ) method with 
baFlleLlst.length = 8 
sOffsetl = 
sLengthl = -1 


Shall throw a 
ArraylndexOutOfBoundsException 




11 


sOffset2 >= baFlleLlst.length 

Call registerFileEvent ( ) method with 
baADFAld. length = 15 
sOffset2 = 15 
bLength2 = 6 


Shall throw a 
ArraylndexOutOfBoundsException 




12 


sOffset2 < 

Call registerFileEvent ( ) method with 
baADFAld. length = 15 
sOffset2 = -1 
bLength2 = 6 


Shall throw a 
ArraylndexOutOfBoundsException 




13 


sLength2 > baFlleLlst.length 

Call registerFileEvent ( ) method with 
baADFAld. length =15 
sOffset2 = 
bLength2 =16 


Shall throw a 
ArraylndexOutOfBoundsException 




14 


sOffset2 + sLength2 > baFlleLlst.length 

Call dereglsterFlleEvent ( ) method with 
baADFAld. length =15 
sOffsetl = 10 
bLengthl = 6 


Shall throw a 
ArraylndexOutOfBoundsException 




15 


ILLEGAL_VALUE Exception 

1- Call registerFileEvent method with 
baADFAld. length =18 

sOffset2 = 
bLength2 = 4 

2- Call registerFileEvent ( ) method with 
baADFAld. length = 18 

sOffset2 = 
bLength2 =18 


1- Shall throw a System Exception 
with ILLEGAL_VALUE reason code 

2- Shall throw a System Exception 
with ILLEGAL_VALUE reason code 




16 


EVENT_MENU_SELECTION not allowed 

Call registerFileEvent method with 
event=EVENT_MENU_SELECTION 


Shall throw a ToolkitException with 
EVENT_NOT_ALLOWED reason 
code 




17 


EVENT_MENU_SELECTION_HELP_REQUEST 
not allowed 

Call registerFileEvent method with 
event= EVENT_MENU_SELECTION_HELP_REQUEST 


Shall throw a ToolkitException with 
EVENT_NOT_ALLOWED reason 
code 




18 


EVENT_TIMER_EXPIRATION not allowed 

Call registerFileEvent ( ) method with 
event=EVENT„TIMER_EXPIRATION 


Shall throw a ToolkitException with 
EVENT_NOT_ALLOWED reason 
code 




19 


EVENT_STATUS_COMMAND not allowed 

Call registerFileEvent ( ) method with 
event=EVENT_STATUS_COMMAND 


Shall throw a ToolkitException with 
EVENT_NOT_ALLOWED reason 
code 




20 


EVENT_NOT_SUPPORTED Exception 

Call registerFileEvent ( ) method with 
event=EVENT_PROFILE_DOWNLOAD 


Shall throw a ToolkitException with 
EVENT_NOT_SUPPORTED 
reason code 
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Id 


Description 


API Expectation 


APDU Expectation 


21 


Register a deleted and recreated EF under MF 

1- Call registerFileEvent ( ) method with 
parameters : 

event= EVENT_EXTERNAL_FILE_UPDATE 
baFileList="01 3F0011116F03" 
baADFAid=null 

2- Update binary on MF\DFTEST\EFTARU 

3- Delete MF\DFTEST\EFTARU 

4- Create MF\DFTEST\EFTARU 

5- Update binary on MF\DFTEST\EFTARU 

6- Call deregisterFileEvent ( ) method with 
parameters : 

event= EVENT_EXTERNAL_FILE_UPDATE 
baFileList="01 3F0011116F03" 
baADFAid=null 


1- No exception Is thrown 

2- Applet Is triggered 
5- Applet is triggered 




22 


Register a deleted and recreated DF under MF 

1- Call registerFileEvent method with 
parameters : 

event= EVENT_EXTERNAL_FILE_UPDATE 
baFileList="01 3F0011112211" 
baADFAid=null 

2- Update binary on 
MF\DFTEST\DFSUB_TEST\EFTAA 

3- Delete DFSUB_TEST 

4- Create DFSUB_TEST, create EFTAA 

5- Update binary on 
MF\DFTEST\DFSUB_TEST\EFTAA 

6- Call deregisterFileEvent ( ) method with 
parameters : 

event= EVENT_EXTERNAL_FILE_UPDATE 
baFileList="01 3F0011112211" 
baADFAid=null 


1- No exception is tlirown 

2- Applet is triggered 
5- Applet is triggered 




23 


Register a non existing EF under MF 

1- Call registerFileEvent method with 
parameters : 

event= EVENT_EXTERNAL_FILE_UPDATE 
baFileList="01 3F00111122 112223" 

baADFAid=null 

2- Create MF\DFTEST\DFSUB TEST\EFTNEW 
(2223) 

3- Update binary on 
MF\DFTEST\DFSUB_TEST\EFTNEW 

4- Call deregisterFileEvent method with 
parameters : 

event= EVENT_EXTERNAL_FILE_UPDATE 
baFileList="01 3F00111122112223" 
baADFAid=null 

5- Delete MF\DFTEST\DFSUB_TEST\EFTNEW 


1- No exception Is thrown 
3- Applet is triggered 
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Id 


Description 


API Expectation 


APDU Expectation 


24 


Register a non existing DF under MF 








1- Call registerFileEvent ( ) method with 
parameters : 


1- No exception is thrown 






event= EVENT_EXTERNAL_FILE_UPDATE 








baFileList="01 3F0011112212" 








baADFAid=null 








2- Create MF\DFTEST\DFNEW (2212) 








3- Create MF\DFTEST\DFNEW\EFTNEW 








4- Update binary on MF\DFTEST\DFNEW\EFTNEW 


4- Applet is triggered 






5- Call deregisterFileEvent method with 
parameters : 


5- Applet is triggered 






event= EVENT_EXTERNAL„FILE_UPDATE 








baFileList="01 3F0011112212" 








baADFAid=null 








6- Delete MF\DFTEST\DFNEW 








7-Restore EFs 







NOTE: Complementary information about tests 21, 22, 23, 24 can be found in document SCPt040568 in ETSI 

web site. 

5.2.8.16 Method registerFileEvent(short event, FileView aFileView) 

Test Area Reference: Api_2_Tkr_RgfeSo. 

5.2.8.16.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void registerFileEvent (short event, 

FileView aFileView) 
throws ToolkitException, 

Java . lang . NullPointerException, 
javacard. framework .TransactionException 

5.2.8.16.1.1 Normal execution 

• CRRN 1 : The only event allowed and supported by the method is E VENT_EXTERN AL_FILE_UPD ATE. 

• CRRN2: The CAT Runtime Environment shall trigger the applet when the aFileView object's current file is 
updated. 

• CRRN3: If the aFileView object's current file is a dedicated file, the Applet shall be triggered when an 
elementary file within this dedicated file is updated. 

• CRRN 4 : A later change in the FileView shall not modify the registration. 

• CRRN5: A call to isEventSet() method for EVENT_EXTERNAL_FILE_UPDATE should return true if the 
registerFileEventO method has been successfully called. 

5.2.8.16.1.2 Parameter errors 

• CRRPl: Shall throw a java.lang. NullPointerException if aFileView is null. 

• CRRP2: Shall throw a javacard.framework.TransactionException if the operation would cause the commit 
capacity to be exceeded. 

• CRRP3: Shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if the event is 
EVENT_MENU_SELECTION. 
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CRRP4: Shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if the event is 
EVENT_MENU_SELECTION_HELP_REQUEST. 

CRRP5: Shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if the event is 
EVENT_TIMER_EXPIRATION. 

CRRP6: Shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if the event is 
EVENT_STATUS_COMMAND. 

CRRP7: Shall throw a ToolkitException with EVENT_NOT_SUPPORTED reason if the event is not 
EVENT EXTERNAL FILE UPDATE. 



5.2.8.16.1.3 
No requirements. 



Context errors 



5.2.8.16.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.8.16.3 



Test area files 

Test_Api_2_Tkr_RgfeSo.java. 
Api_2_Tkr_RgfeSo _Ljava. 
api_2_tkr_rgfeso .cap. 

Test coverage 



CRR number 


Test case number 


N1 


1,2,3,4 


N2 


1, 3, 11, 12 


N3 


2,4 


N4 


1,3 


N5 


1 


P1 


5 


P2 


Not testable 


P3 


6 


P4 


7 


P5 


8 


P6 


9 


P7 


10 
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5.2.8.16.4 



Test procedure 



Id 



Description 



API Expectation 



APDU Expectation 



Register EF under IVIF 



1- Call isEventSet 
(EVENT_EXTERNAL_FILE_UPDATE) method 



2- Call UICCView=getTheUICCView() 

3- Applet selects MF\DFTEST\EFTARU . 

4- Call registerFileEvent ( ) method with 
parameters : 

event= EVENT_EXTERNAL_FILE_UPDATE 
aFileView = UlCCView 

5- Update binary on MF\DFTEST\EFTARU 



6- Call isEventSet 
(EVENT_EXTERNAL_FILE_UPDATE) method 

7- Applet selects EFCARU. 

8- Call registerFileEvent ( ) method with 
parameters : 

event= EVENT_EXTERNAL_FILE_UPDATE 
aFileView = UlCCView 

9- Update binary on MF\DFTEST\EFTARU 

10- Increase on MF\DFTEST\EFCARU 

11- Update record on MF\DFTEST\EFLARU 

12- Update binary on MF\DFTEST\ 
DFSUB_TEST\EFTAA 

13- Call deregisterFileEvent ( ) method with 
parameters : 

event= EVENT_EXTERNAL_FILE_UPDATE 
aFileView = UlCCView 

14- Applet selects MF\DFTEST\EFTARU. 

15- Call deregisterFileEvent ( ) method with 
parameters : 

event= EVENT_EXTERNAL_FILE_UPDATE 
aFileView = UlCCView 



1- Returns false 



5- Applet is triggered 



6- Returns true 

8- No exception is tlirown 

9- Applet is triggered 

10- Applet is triggered 

1 1 - Applet is not triggered 
12- Applet is not triggered 
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Id 


Description 


API Expectation 


APDU Expectation 


2 


Register DF under MF 

1- Applet selects MF\DFTEST. 








2- Call registerFileEvent method with 


2- No exception is thrown 






parameters : 








event= EVENT_EXTERNAL_FILE_UPDATE 








aFileView = DICCView 








3- Update binary on MF\DFTEST\EFTARU 


3- Applet is triggered 






4- Increase on MF\DFTEST\EFCARU 


4- Applet is triggered 






5- Update record on MF\DFTEST\EFLARU 


5- Applet is triggered 






6- Update binary on MF\DFTEST\ 
DFSUB_TEST\EFTAA 


6- Applet is not triggered 






7- Applet selects MF\DFTEST 








8- Call deregisterFileEvent method with 








parameters : 








event= EVENT_EXTERNAL_FILE_UPDATE 








aFileView = UlCCView 






3 


Register EF under ADF1 

1- Call ADFlView=getTheFileView() 

2- Applet selects ADF1\DFTEST\EFTARU. 








3- Call registerFileEvent method with 
parameters : 


3- No exception is thrown 






event= EVENT_EXTERNAL_FILE_UPDATE 








aFileView = ADFlView 








4- Update binary on ADF1\DFTEST\EFTARU 








5- Applet selects ADF1\DFTEST\EFCARU. 


4- Applet is triggered 






6- Call registerFileEvent ( ) method with 








parameters : 








event= EVENT_EXTERNAL_FILE_UPDATE 








aFileView = ADFlView 


6- No exception is thrown 






7- Update binary on ADF1\DFTEST\EFTARU 








8- Increase on ADF1\DFTEST\EFCARU 

9- Update record on ADF1\DFTEST\EFLARU 


7- Applet is triggered 






10- Update binary on ADF1\DFTEST\ 


8- Applet is triggered 






DFSUB_TEST\EFTAA 


9- Applet is not triggered 






11- Applet selects ADF1\DFTEST\EFCARU. 


10- Applet is not triggered 






12- Call deregisterFileEvent ( ) method with 








parameters : 








event= EVENT_EXTERNAL_FILE_UPDATE 








aFileView = ADFlView 








13- Applet selects ADF1\DFTEST\EFTARU. 








14- Call deregisterFileEvent ( ) method with 








parameters : 








event= EVENT_EXTERNAL_FILE_UPDATE 








aFileView = ADFlView 







ETSI 



Release 6 



365 



ETSI TS 102 268 V6.0.0 (2007-03) 



Id 


Description 


API Expectation 


APDU Expectation 


4 


Register DF under ADF1 

1- Applet selects DFTEST. 

2- Call registerFileEvent method with 
parameters : 

event= EVENT_EXTERNAL_FILE_DPDATE 
aFileView = ADFlView 

3- Update binary on ADF1\DFTEST\EFTARU 

4- Increase on ADF1\DFTEST\EFCARU 

5- Update record on ADF1\DFTEST\EFLARU 

6- Update binary on ADF1\DFTEST\ 
DFSUB_TEST\EFTAA 

7- Applet selects ADFINDFTEST 

8- Call deregisterFileEvent method with 
parameters : 

event= EVENT_EXTERNAL_FILE_UPDATE 
aFileView = ADFlView 


2- No exception is thrown 

3- Applet is triggered 

4- Applet is triggered 

5- Applet is triggered 

6- Applet is not triggered 




5 


NullPointerException Exception 

Call registerFileEvent method with null 
aFileView 


Shall throw a NullPointerException 




6 


EVENT_IVIENU_SELECTION not allowed 

Call registerFileEvent ( ) method with 
event=EVENT_MENU_SELECTION 


Shall throw a ToolkitException with 
EVENT_NOT_ALLOWED reason 
code 




7 


EVENT_MENU_SELECTION_HELP_REQUEST 
not allowed 

Call registerFileEvent {) method with 
event= EVENT MENU SELECTION_HELP_REQUEST 


Shall throw a ToolkitException with 
EVENT_NOT_ALLOWED reason 
code 




8 


EVENT_TIMER_EXPIRATION not allowed 

Call registerFileEvent method with 
event=EVENT_TIMER_EXPIRATION 


Shall throw a ToolkitException with 
EVENT_NOT_ALLOWED reason 
code 




9 


EVENT_STATUS_COMMAND not allowed 

Call registerFileEvent method with 
event=EVENT_STATUS_COMMAND 


Shall throw a ToolkitException with 
EVENT_NOT_ALLOWED reason 
code 




10 


EVENT_NOT_SUPPORTED Exception 

Call registerFileEvent method with 
event=EVENT_PROFILE_DOWNLOAD 


Shall throw a ToolkitException with 
EVENT_NOT_SUPPORTED 
reason code 




11 


Register a deleted and recreated EF under ADF 

1- Applet selects ADFIXDFtestNEFtaho 

2- Call registerFileEvent method with 
parameters : 

event= EVENT_EXTERNAL_FILE_UPDATE 
aFileView = ADFlView 

3- Update binary on ADFINDFiestXEFtaro 

4- Delete ADFl\DFiEST\EFiaEn 

5- Create ADFl\DFiEST\EFiaEn 

6- Update binary on ADFIXDFtestNEFtaho 

7- Call deregisterFileEvent method with 
parameters : 

event= EVENT_EXTERNAL_FILE_UPDATE 
aFileView = ADFlView 


2- No exception is thrown 

3- Applet is triggered 

6- Applet is triggered 





£75/ 



Release 6 



366 



ETSI TS 102 268 V6.0.0 (2007-03) 



Id 


Description 


API Expectation 


APDU Expectation 


12 


Register a deleted and recreated DF under ADF 








1- Applet selects ADFINDFtestNDFsob.test 


2- No exception is thrown 






2- Call registerFileEvent method with 








parameters : 








event= EVENT_EXTERNAL_FILE_UPDATE 








aFileView = ADFlView 








3- Update binary on ADF1\DFtest\ 


3- Applet is triggered 






DFsub_test\EFtaa 








4- Delete EFisa, delete DFsob_tesi 








5- Create DFsnB_TEST, create EFtaa 








6- Update binary on ADF1\DFtest\ 
DFsuB_TEST \ EFtaa 


6- Applet is triggered 






7- Applet selects ADF1\DFiest\ DFsobjest 








8- Call deregisterFileEvent method with 








parameters : 








event= EVENT_EXTERNAL_FILE_UPDATE 








aFileView = ADFlView 








9- Restore EFs 







NOTE: Complementary information about tests 11,12 can be found in document SCPt040568 in ETSI web site. 

5.2.8.17 Method deregisterFileEvent(short event, byte[] baFileList, short sOffsetl , 
short sLengthI , byte[] baADFAid, short sOffset2, byte bLength2) 

Test Area Reference: Api_2_Tkr_Drfes_Bss_Bsb. 

5.2.8.17.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void deregisterFileEvent (short event, 

byte[] baFileList, 
short sOffsetl, 
short sLengthl, 
byte[] baADFAid, 
short sOffset2, 
byte bLength2) 
throws ToolkitException, 

Java . lang . NullPointerException, 
Java .lang . ArraylndexOutOfBoundsException, 
javacard. framework .TransactionException, 
javacard. framework . SystemException 

5.2.8.17.1.1 Normal execution 

• CRRN 1 : The only event allowed and supported by the method is EVENT_EXTERNAL_FILE_UPD ATE. 

• CRRN2: The applet is deregistered to the file included in the baFileList. 

• CRRN3: If a file in baFileList is a dedicated file the deregistration shall not affect the monitoring of an 
elementary file within the dedicated file that was individually registered. 

• CRRN4: If a file in baFileList is an elementary file the deregistration will not affect the monitoring of the 
parent dedicated file that was individually registered. 

• CRRN5: The baADFAid indicates the Aid of the ADF under which the file is located. 

• CRRN6: If baADFAid is null, it indicates that the file is located under the MF and not located under an ADF. 
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• CRRN7: A call to isEventSet() method for EVENT_EXTERNAL_FILE_UPDATE should return false if the 
applet has been deregistered completely to all its registered EFs and DFs. 

5.2.8.17.1.2 Parameter errors 

CRRPl: Shall throw a java.lang.NullPointerException if baFileList is null. 

CRRP2: Shall throw a java.lang.ArraylndexOutOfBoundsException if sOffsetl or sLengthl or both would 
cause access outside array bounds. 

CRRP3: Shall throw a java.lang.ArraylndexOutOfBoundsException if sOffset2 or sLength2 or both would 
cause access outside array bounds. 

CRRP4: Shall throw a javacard.framework.TransactionException if the operation would cause the commit 
capacity to be exceeded. 

CRRP5: Shall throw a javacard.framework.SystemException with ILLEGAL_VALUE reason if bLength2 is 
not in the range of 5 - 16 bytes. 

CRRP6: Shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if the event is 
EVENT_MENU_SELECTION. 

CRRP7: Shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if the event is 
EVENT_MENU_SELECTION_HELP_REQUEST. 

CRRP8: Shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if the event is 
EVENT_TIMER_EXPIRATION. 

CRRP9: Shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if the event is 
EVENT_STATUS_COMMAND. 

CRRPIO: Shall throw a ToolkitException with EVENT_NOT_SUPPORTED reason if the event is not 
EVENT_EXTERNAL_FILE_UPDATE. 

5.2.8.17.1.3 Context errors 
No requirements. 

5.2.8.17.2 Test area files 

Test Source: Test_Api_2_Tkr_Drfes_Bss_Bsb.java. 
Test Applet: Api_2_Tkr_Drfes_Bss_Bsb _l.java. 

Cap File: api_2_tkr_drfes_bss_bsb.cap. 
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5.2.8.17.3 



Test coverage 



CRR number 


Test case number 


N1 


1,2,3,4,5,6 


N2 


1,4 


N3 


2,5 


N4 


3,6 


N5 


4,5,6 


N6 


1,2,3 


N7 


1 


P1 


7 


P2 


8,9, 10, 11, 12 


P3 


13, 14, 15, 16 


P4 


Not testable 


P5 


17 


P6 


18 


P7 


19 


P8 


20 


P9 


21 


P10 


22 



5.2.8.17.4 



Test procedure 



Id 



Description 



API Expectation 



APDU Expectation 



Deregister EF under MF 



1- Call isEventSet 
(EVENT_EXTERNAL_FILE_UPDATE) method 

2- Call registerFileEvent ( ) method with 
parameters : 

event= EVENT_EXTERNAL_FILE_UPDATE 
baFileList="03 3F0011116F03 3F0011116F0S 
3F0011116F0C" 
baADFAid=null 



3- Update binary on MFXDFTESTXEFxARn 

4- Increase on MENDFiestNEFcaro 

5- Update record on MF\DFiEST\EFLARn 

6- Call deregisterFileEvent ( ) method with 
parameters : 

event= EVENT_EXTERNAL_FILE_UPDATE 
baFileList="02 3F0011116F03 3F0011116F09" 
baADFAid=null 

7- Update binary on MENDFiestNEFtaro 

8- Increase on MENDFtestNEFcaro 

9- Update record on MEXDEiestXEFlaro 



10- Call isEventSet 
(EVENT_EXTERNAL_FILE_UPDATE) method 

11- Call deregisterFileEvent ( ) method with 
parameters : 

event= EVENT_EXTERNAL_FILE_UPDATE 
baFileList="01 3F0011116F0C" 
baADFAid=null 

12- Update record on MENDEtestNEFlaro 

13- Call isEventSet 
(EVENT_EXTERNAL_FILE_UPDATE) method 



1- Returns false 



3- Applet is triggered 

4- Applet is triggered 

5- Applet is triggered 

6- No exception is thrown 



7- Applet is not triggered 

8- Applet is not triggered 

9- Applet is triggered 

10- Returns true 

11- No exception is thrown 

12- Applet is not triggered 

13- Returns false 
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Id 


Description 


API Expectation 


APDU Expectation 


2 


Deregister DF does not affect child EF 

1- Call registerFileEvent ( ) method with 
parameters : 

event= EVENT_EXTERNAL_FILE_UPDATE 
baFileList="02 3F0011116F03 3F001111" 
baADFAid=null 

2- Update binary on MFNDFtestNEFtaho 

3- Call deregisterFileEvent ( ) method with 
parameters : 

event= EVENT_EXTERNAL_FILE_UPDATE 
baFileList="01 3F001111" 
baADFAid=null 

4- Update binary on MFXDFtestNEFtaro 


2- Applet is triggered 

3- No exception is tlirown 

4- Applet is triggered 




3 


Deregister EF does not affect parent DF 

1- Call registerFileEvent method with 
parameters : 

event= EVENT_EXTERNAL_FILE_UPDATE 
baFileList="01 3F001111" 
baADFAid=null 

2- Update binary on MF\DFTEST\EFiaRn 

3- Call deregisterFileEvent method with 
parameters : 

event= EVENT_EXTERNAL_FILE_UPDATE 
baFileList="01 3F0011116F03" 
baADFAid=null 

4- Update binary on MFXDFiESTXEFxaRn 

5- Update record on MENDFiestNEFlaro 


2- Applet is triggered 

3- No exception is tlirown 

4- Applet is triggered 

5- Applet is triggered 
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Id 


Description 


API Expectation 


APDU Expectation 


4 


Deregister EF under ADF1 








1- Call isEventSet 


1- Returns false 






(EVENT_EXTERNAL_FILE_UPDATE) method 








2- Call registerFileEvent method with 








parameters : 








event= EVENT_EXTERNAL_FILE_UPDATE 








baFileList="03 3F007FFF11116F03 








3F007FFF11116F0 9 3F007FFF1111 6F0C" 








baADFAid="AID ADFl" 








3- Update binary on MF\DFTEST\EFiaRn 


3- Applet Is triggered 






4- Increase on MENDFiestNEFcaro 


4- Applet Is triggered 






5- Update record on MENDFtestNEFlaro 


5- Applet is triggered 






6- Call deregisterFileEvent method with 


6- No exception is thrown 






parameters : 








event= EVENT_EXTERNAL_FILE_UPDATE 








baFileList="02 3F007FFF11116F03 








3F007FFF11116F09" 








baADFAid="AID ADFl" 








7- Update binary on MENDFtestNEFtaro 


7- Applet Is not triggered 






8- Increase on MF\DFiEST\EFcARn 


8- Applet Is not triggered 






9- Update record on MENDFtestNEFlaro 


9- Applet Is triggered 






10- Call isEventSet 


10- Returns true 






(EVENT_EXTERNAL_FILE_UPDATE) method 








11- Call deregisterFileEvent method with 
parameters : 


1 1- No exception Is thrown 






event= EVENT_EXTERNAL_FILE_UPDATE 








baFileList="01 3F007FFF11116F0C" 








baADFAid="AID ADFl" 








12- Update record on MEXDEtestNEElaro 


12- Applet is not triggered 






13- Call isEventSet 
(EVENT_EXTERNAL_FILE_UPDATE) method 


13- Returns false 




5 


Deregister DF does not affect child EF (under 
ADF1) 

1- Call registerFileEvent ( ) method with 
parameters : 

event= EVENT_EXTERNAL_FILE_UPDATE 
baFileList="02 3F007FFF11116F03 3F001111" 








baADFAid="AID ADFl" 


2- Applet is triggered 






2- Update binary on MF\DFTEST\EFTARU 


3- No exception Is thrown 






3- Call deregisterFileEvent ( ) method with 








parameters : 








event= EVENT_EXTERNAL_FILE_UPDATE 








baFileList="01 3F007FFF1111" 








baADFAid="AID ADFl" 








4- Update binary on MF\DFTEST\EFTARU 


4- Applet is triggered 
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Id 


Description 


API Expectation 


APDU Expectation 


6 


Deregister EF does not affect parent DF (under 
ADF1) 

1- Call registerFileEvent method with 
parameters : 

event= EVENT_EXTERNAL_FILE_UPDATE 
baFileList="01 3F007FFF1111" 
baADFAid="AID ADFl" 

2- Update binary on MF\DFiEST\EFiaRn 

3- Call deregisterFileEvent method with 
parameters : 

event= EVENT_EXTERNAL_FILE_UPDATE 
baFileList="01 3F007FFF11116F03" 
baADFAid="AID ADFl" 

4- Update binary on MFNDFtestNEFtaro 

5- Update record on MFXDFtestNEFlaro 

6- Restore EFs 


1- No exception is thrown 

2- Applet Is triggered 

3- No exception is thrown 

4- Applet Is triggered 

5- Applet Is triggered 




7 


NullPointerException Exception 

Call deregisterFileEvent method with 
baFileList null 


Shall throw a NullPointerException 




8 


sOffsetl >= baFileList.length 

Call deregisterFileEvent method with 
baFileList.length = 7 
sOffsetl = 8 
sLengthl = 4 


Shall throw a 
ArraylndexOutOfBoundsException 




9 


sOffsetl < 

Call deregisterFileEvent method with 
baFileList.length = 19 
sOffsetl = -1 
sLengthl = 4 


Shall throw a 
ArraylndexOutOfBoundsException 




10 


sLengthl > baFileList.length 

Call deregisterFileEvent method with 
baFileList.length = 7 
sOffsetl = 
sLengthl = 10 


Shall throw a 
ArraylndexOutOfBoundsException 




11 


sOffsetl + sLengthl > baFileList.length 

Call deregisterFileEvent method with 
baFileList.length = 7 
sOffsetl = 5 
sLengthl = 4 


Shall throw a 
ArraylndexOutOfBoundsException 




12 


sLengthl < 

Call deregisterFileEvent method with 
baFileList.length = 7 
sOffsetl = 
sLengthl = -1 


Shall throw a 
ArraylndexOutOfBoundsException 




13 


sOffset2 >= baFileList.length 

Call deregisterFileEvent method with 
baADFAid. length =15 
sOffset2 = 15 
bLength2 = 6 


Shall throw a 
ArraylndexOutOfBoundsException 




14 


sOffset2 < 

Call deregisterFileEvent method with 
baADFAid. length =15 
sOffset2 = -1 
bLength2 = 6 


Shall throw a 
ArraylndexOutOfBoundsException 




15 


sLength2 > baFileList.length 

Call deregisterFileEvent method with 
baADFAid. length = 15 
sOffset2 = 
bLength2 =16 


Shall throw a 
ArraylndexOutOfBoundsException 
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Id 


Description 


API Expectation 


APDU Expectation 


16 


sOffset2+ sLength2 > baFileList.length 

Call deregisterFileEvent ( ) method with 
baADFAid. length =15 
sOffsetl = 10 
bLengthl = 6 


Shall throw a 
ArraylndexOutOfBoundsException 




17 


ILLEGAL_VALUE Exception 

1- Call deregisterFileEvent ( ) method with 
baADFAid. length =18 

sOffset2 = 
bLength2 = 4 

2- Call deregisterFileEvent method with 
baADFAid. length =18 

sOffset2 = 
bLength2 =18 


1- Shall throw a System Exception 
with ILLEGAL_VALUE reason code 

2- Shall throw a System Exception 
with ILLEGAL_VALUE reason code 




18 


EVENT_IVIENU_SELECTION not allowed 

Call deregisterFileEvent method with 
event=EVENT_MENU_SELECTION 


Shall throw a ToolkitException with 
EVENT_NOT_ALLOWED reason 
code 




19 


EVENT_MENU_SELECTION_HELP_REQUEST 
not allowed 

Call deregisterFileEvent method with 
event= EVENT_MENU_SELECTION_HELP_REQUEST 


Shall throw a ToolkitException with 
EVENT_NOT_ALLOWED reason 
code 




20 


EVENT_TIMER_EXPIRATION not allowed 

Call deregisterFileEvent method with 
event=EVENT_TIMER_EXPIRATION 


Shall throw a ToolkitException with 
EVENT_NOT_ALLOWED reason 
code 




21 


EVENT_STATUS_COMMAND not allowed 

Call deregisterFileEvent method with 
event=EVENT_STATUS_COMMAND 


Shall throw a ToolkitException with 
EVENT_NOT_ALLOWED reason 
code 




22 


EVENT_NOT_SUPPORTED Exception 

Call deregisterFileEvent ( ) method with 
event=EVENT_PROFILE_DOWNLOAD 


Shall throw a ToolkitException with 
EVENT_NOT_SUPPORTED 
reason code 





5.2.8.18 Method deregisterFileEvent(short event, FileView aFileView) 

Test Area Reference: Api_2_Tkr_Drfeso. 

5.2.8.18.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void deregisterFileEvent (short event, 

FileView aFileView) 
throws ToolkitException, 

Java . lang . NullPointerException, 
javacard. framework .TransactionException 

5.2.8.18.1.1 Normal execution 

• CRRN 1 : The only event allowed and supported by the method is E VENT_EXTERN AL_FILE_UPD ATE. 

• CRRN2: The aFileView object's current file indicates the file that is no longer monitored. The applet is 
deregistered to the aFileView object's current file. 

• CRRN3: If the current file is a dedicated file the deregistration shall not affect the monitoring of an elementary 
file within the dedicated file that was individually registered. 

• CRRN4: If the current file is an elementary file the deregistration will not affect the monitoring of the parent 
dedicated file that was individually registered. 

• CRRN5: A call to isEventSet() method for EVENT_EXTERNAL_FILE_UPDATE should return false if the 
applet has been deregistered completely to all its registered EFs and DFs. 
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5.2.8.18.1.2 Parameter errors 

CRRPl: Shall throw ajava.lang.NullPointerException if aFileView is null. 

CRRP2: Shall throw a javacard.framework.TransactionException if the operation would cause the commit 
capacity to be exceeded. 

CRRP3: Shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if the event is 
EVENT_MENU_SELECTION. 

CRRP4: Shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if the event is 
EVENT_MENU_SELECTION_HELP_REQUEST. 

CRRP5: Shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if the event is 
EVENT_TIMER_EXPIRATION. 

CRRP6: Shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if the event is 
EVENT_STATUS_COMMAND. 

CRRP7: Shall throw a ToolkitException with EVENT_NOT_SUPPORTED reason if the event is not 
EVENT EXTERNAL FILE UPDATE. 



5.2.8.18.1.3 
No requirements. 

5.2.8.18.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.8.18.3 



Context errors 
Test area files 

Test_Api_2_Tkr_Drfeso.java. 
Api_2_Tkr_Drfeso_l .Java. 
api_2_tkr_drfeso .cap. 

Test coverage 



CRR number 


Test case number 


N1 


1,2,3,4,5,6 


N2 


1,4 


N3 


2,5 


N4 


3,6 


N5 


1 


PI 


7 


P2 


Not testable 


P3 


8 


P4 


9 


P5 


10 


P6 


11 


P7 


12 
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5.2.8.18.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Deregister EF under MF 








1- Call isEventSet 
(EVENT_EXTERNAL_FILE_UPDATE) method 


1- Returns false 






2- Call registerFileEvent method with 








parameters : 








event= EVENT_EXTERNAL_FILE_UPDATE 








baFileList="03 3F0011116F03 3F0011116F09 








3F0011116F0C" 








baADFAid=null 








3- Update binary on MFXDFTESTNEFxARn 


3- Applet Is triggered 






4- Increase on MFNDFtestNEFcaro 


4- Applet is triggered 






5- Update record on MFNOFiestNEFlaro 


5- Applet is triggered 






6- Call UICCView=getTheUICCView() 








7- Applet selects EFiaRo ■ 








8- Call deregisterFileEvent method with 


8- No exception Is thrown 






parameters : 








event= EVENT_EXTERNAL_FILE_UPDATE 








aFileView = UlCCView 








9- Update binary on MENDFtestXEFtaro 


9- Applet Is not triggered 






10- Applet selects EFcaro. 








11- Call deregisterFileEvent method with 








parameters : 

event= EVENT_EXTERNAL_FILE_UPDATE 


1 1- No exception Is thrown 






aFileView = UlCCView 








12- Increase on MFXDFtestXEFcaro 


12- Applet is not triggered 






13- Call isEventSet 


13- Returns true 






(EVENT_EXTERNAL_FILE_UPDATE) method 








14- Applet selects EFlaro. 








15- Call deregisterFileEvent ( ) method with 
parameters : 


15- No exception Is thrown 






event= EVENT_EXTERNAL_FILE_UPDATE 








aFileView = UlCCView 








16- Update record on MENDFtestNEFlaro 


16- Applet is not triggered 






17- Call isEventSet 
(EVENT_EXTERNAL_FILE_UPDATE) method 


17- Returns false 




2 


Deregister DF does not affect child EF 

1- Call registerFileEvent ( ) method with 

parameters : 

event= EVENT_EXTERNAL_FILE_UPDATE 

baFileList="02 3F0011116F03 3F001111" 

baADFAid=null 








2- Update binary on MF\DFiEST\EFiARn 

3- Applet selects DFiest- 


2- Applet is triggered 






4- Call deregisterFileEvent ( ) method with 
parameters : 


4- No exception Is thrown 






event= EVENT_EXTERNAL_FILE_UPDATE 








aFileView = UlCCView 








5- Update binary on MF\DFTEST\EFTARn 


5- Applet is triggered 





ETSI 



Release 6 



375 



ETSI TS 102 268 V6.0.0 (2007-03) 



Id 


Description 


API Expectation 


APDU Expectation 


3 


Deregister EF does not affect parent DF 

l-Select DFtest 

2- Call registerFileEvent method with 

parameters : 

event= EVENT_EXTERNAL_FILE_DPDATE 








aFileView = UlCCView 


3- Applet is triggered 






3- Update binary on MFXDFtestNEFtaro 








4- Applet selects EFtaro. 








5- Call deregisterFileEvent method with 


5- No exception is tlirown 






parameters : 








event= EVENT_EXTERNAL_FILE_UPDATE 








aFileView = UlCCView 








6- Update binary on MENDFtestNEFtaro 

7- Update record on MFNDFtestNEFlaro 


6- Applet is triggered 

7- Applet is triggered 




4 


Deregister EF under ADF1 

1- Call registerFileEvent ( ) method with 
parameters : 

event= EVENT_EXTERNAL_FILE_UPDATE 
baFileList="03 3F007FFF11116F03 
3F007FFF11116F09 3F007FFF1111 6F0C" 








baADFAid="AID ADFl" 

2- Update binary on MF\DFiEST\EFiARn 


2- Applet is triggered 






3- Increase on MENDFtestNEFcaro 


3- Applet is triggered 






4- Update record on MENDFiestNEFlaro 


4- Applet is triggered 






5- Call ADFlView=getTheFileView() 








6- Applet selects EFtaro. 








7- Call deregisterFileEvent ( ) method with 








parameters : 

event= EVENT_EXTERNAL_FILE_UPDATE 


7- No exception is thrown 






aFileView = ADFlView 








8- Update binary on MEXDEiestXEFiaro 


8- Applet is not triggered 






9- Applet selects EFcaro- 








10- Call deregisterFileEvent method with 








parameters : 








event= EVENT_EXTERNAL_FILE_UPDATE 








aFileView = ADFlView 


10- No exception is thrown 






11- Increase on MENDFiestXEFcaro 








12- Applet selects EFlaro. 


1 1 - Applet is not triggered 






13- Call deregisterFileEvent method with 








parameters : 








event= EVENT_EXTERNAL_FILE_UPDATE 








aFileView = ADFlView 








14- Update record on MEXDEiestXEFlaro 


13- No exception is thrown 

14- Applet is not triggered 
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Id 


Description 


API Expectation 


APDU Expectation 


5 


Deregister DF does not affect child EF (under 
ADF1) 

1- Call registerFileEvent method with 
parameters : 

event= EVENT_EXTERNAL_FILE_UPDATE 
baFileList="02 3F007FFF11116F03 
3F007FFF1111" 
baADFAid="AID ADFl" 

2- Update binary on MF\DFTEST\EFiaRn 

3- Applet selects DFtest- 

4- Call deregisterFileEvent ( ) method with 
parameters : 

event= EVENT_EXTERNAL_FILE_UPDATE 
aFileView = ADFlView 

5- Update binary on MF\DFiEST\EFiaHn 


2- Applet is triggered 

4- No exception Is tlirown 

5- Applet is triggered 




6 


Deregister EF does not affect parent DF (under 
ADFl) 

1- Call registerFileEvent method with 
parameters : 

event= EVENT_EXTERNAL_FILE_UPDATE 
aFileView = ADFlView 

2- Update binary on MFNDFtestNEFtaro 

3- Applet selects EFiaRo. 

4- Call deregisterFileEvent method with 
parameters : 

event= EVENT_EXTERNAL_FILE_UPDATE 
aFileView = ADFlView 

5- Update binary on MFNDFtestNEFtaro 

6- Update record on MENDFiestNEFlaro 

7- Restore EFs 


1- No exception is thrown 

2- Applet Is triggered 

4- No exception Is thrown 

5- Applet is triggered 

6- Applet is triggered 




7 


NullPointerException Exception 

Call registerFileEvent ( ) method with null 
aFileView 


Shall throw a NullPointerException 




8 


EVENT_MENU_SELECTION not allowed 

Call registerFileEvent ( ) method with 
event=EVENT_MENU_SELECTION 


Shall throw a ToolkitException with 
EVENT_NOT_ALLOWED reason 
code 




9 


EVENT_MENU_SELECTION_HELP_REQUEST 
not allowed 

Call registerFileEvent ( ) method with 
event= EVENT_MENU_SELECTION_HELP_REQUEST 


Shall throw a ToolkitException with 
EVENT_NOT_ALLOWED reason 
code 




10 


EVENT_TIMER_EXPIRATION not allowed 

Call registerFileEvent ( ) method with 
event=EVENT_TIMER_EXPIRATION 


Shall throw a ToolkitException with 
EVENT_NOT_ALLOWED reason 
code 




11 


EVENT_STATUS_COMMAND not allowed 

Call registerFileEvent method with 
event=EVENT_STATUS_COMMAND 


Shall throw a ToolkitException with 
EVENT_NOT_ALLOWED reason 
code 




12 


EVENT_NOT_SUPPORTED Exception 

Call registerFileEvent method with 
event=EVENT_PROFILE_DOWNLOAD 


Shall throw a ToolkitException with 
EVENT_NOT_SUPPORTED 
reason code 
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5.2.8.19 Method setMenuEntryTextAttribute 

Test Area Reference: Api_2_Tkr_Smta. 

5.2.8.19.1 Conformance requirement 

The method with following header shall be compliant to its definition in the APT 

public void setMenuEntryTextAttribute (byte id, 

byte[] textAttribute, 
short offset, 
short length) 
throws Java . lang . NullPointerException, 

Java .lang . Array IndexOut Of BoundsExcept ion. 

Toolkit Except ion, 

javacard. framework . TransactionException 

5.2.8.19.1.1 Normal execution 

• CRRNl: Sets the text attribute of a menu entry. 

• CRRN2: The text attribute provided will be added to the text attribute list of the item text attribute list 
Comprehension TLV. 

• CRRN3: After the invocation of this method, during the current card session, the CAT Runtime Environment 
shall dynamically update the menu stored in the terminal. 

5.2.8.19.1.2 Parameter errors 

• CRRPl: Shall throw a java.lang. NullPointerException if textAttribute is null. 

• CRRP2: Shall throw a java.lang. ArraylndexOutOfBoundsException if offset or length or both would cause 
access outside array bounds. 

• CRRP3: Shall throw a ToolkitException with MENU_ENTRY_NOT_FOUND reason if the menu entry does 
not exist for this applet. 

• CRRP4: Shall throw a ToolkitException with B AD_INPUT_PARAMETER reason if the length is different 
from 4. 

• CRRP5: Shall throw a javacard.framework.TransactionException if the operation would cause the commit 
capacity to be exceeded. 

5.2.8.19.1.3 Context errors 
No requirements. 

5.2.8.19.2 Test area files 

Test Source: Test_ Api_2_Tkr_Smta.java. 
Test Applet: Api_2_Tkr_Smta _1 .Java. 

Cap File: api_2_tkr_smta.cap. 
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5.2.8.19.3 



Test coverage 



CRR number 


Test case number 


N1 


1,2 


N2 


1,2 


N3 


1,2 


P1 


3 


P2 


4, 5, 6, 7 


P3 


8 


P4 


9 


P5 


Not testable 



5.2.8.19.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Text attribute update 1 

Call setMenuEntryTextAttribute with 
parameters : 

Id = '02' 

textAttribute= "00 OC 11 02 00 OC 10 03" 

Offset = 

Length = 4 


No exception shall be thrown. 


The UICC shall issue a 
SETUP MENU proactive 
command which contains 
the text Attribute list value 
"00 00 03 90" "00 OC 1 1 02" 
"00 00 03 90" "00 00 03 90" 


2 


Text attribute update 2 

Call SetMenuEntryTextAttribute with 
parameters : 

Id = '04' 

textAttribute= "00 OC 11 02 00 OC 10 03" 

Offset = 4 

Length = 4 


No exception shall be thrown. 


The UICC shall issue a 
SETUP MENU proactive 
command which contains 
the text Attribute list value 
"00 00 03 90" "00 OC 1 1 02" 
"00 00 03 90" "00 OC 10 03" 


3 


Call setMenuEntryTextAttributeO with null 
textAttribute 


Shall throw a NullPointerException 




4 


DstOffset >= dstBuffer.length 

SetMenuEntryTextAttribute () 
dstBuffer.length = 8 
dstOffset = 8 
dstLength = 4 


Shall throw a 
ArraylndexOutOfBoundsException 




5 


dstOffset < 

SetMenuEntryTextAttribute () 
dstBuffer.length = 8 
dstOffset = -1 
dstLength = 4 


Shall throw a 
ArraylndexOutOfBoundsException 




6 


DstLength > dstBuffer.length 

SetMenuEntryTextAttribute {) 
dstBuffer.length = 3 
dstOffset = 
dstLength = 4 


Shall throw a 
ArraylndexOutOfBoundsException 




7 


dstOffset + dstLength > dstBuffer.length 

SetMenuEntryTextAttribute () 
dstBuffer.length = 8 
dstOffset = 5 
dstLength = 4 


Shall throw a 
ArraylndexOutOfBoundsException 




8 


MENU_ENTRY_NOT_FOUND exception 

Call SetMenuEntryTextAttributeO with Id = 
08 


Shall throw a ToolkitException with 
MENU_ENTRY_NOT_FOUND 
reason code 




9 


BADJNPUT_PARAMETER exception 

Call SetMenuEntryTextAttributeO with 
length = 2 


Shall throw a ToolkitException with 
BAD INPUT PARAMETER reason 





ETSI 



Release 6 



379 



ETSI TS 102 268 V6.0.0 (2007-03) 



Id 


Description 


API Expectation 


APDU Expectation 






code 





5.2.9 Interface ViewHandler 

Tests are done in inheriting interfaces EnvelopeHandler, EnvelopeResponseHandler, ProactiveHandler and 
ProactiveResponseHandler. 

5.2.10 Interface BERTLVEditHandler 
5.2.10.1 Method setTag 

Test Area Reference: Api_2_Bte_Sttg. 

5.2.1 0.1 .1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void setTag (byte bBERTag) 

5.2.10.1.1.1 Normal execution 

• CRRN 1 : Sets the tag of the BER TLV list. 



5.2.10.1.1.2 
No requirements. 

5.2.10.1.1.3 

No requirements. 

5.2.10.1.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.10.1.3 



Parameter errors 
Context errors 

Test area files 

Test_Api_2_Bte_Sttg.java. 
Api_2_Bte_Sttg_l .Java. 
api_2_bte_sttg.cap. 

Test coverage 



CRR number 


Test case number 


1 


1 



5.2.10.1.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Get a BERTLVEditHandler using 

buildTLVHandler with type BER_EDIT_HANDLER 
and capacity 0x10 






1 


1- setTag(OxOl) 

2- getTagO 


2- Returns 0x01 
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5.2.10.2 Method getTag 

Test Area Reference: Api_2_Bte_Gttg. 

5.2.10.2.1 Conformance requirement 

The method with following header shall be compliant to its definition in the APT 

public byte getTag () 

5.2.10.2.1.1 Normal execution 

• CRRNl : Returns the BER Tag of the BER TLV list. 



5.2.10.2.1.2 
No requirements. 

5.2.10.2.1.3 

No requirements. 

5.2.10.2.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.10.2.3 



Parameter errors 
Context errors 

Test area files 

Test_Api_2_Bte_Gttg.java. 
Api_2_Bte_Gttg_l .Java. 
api_2_bte_gttg. cap . 

Test coverage 



CRR number 


Test case number 


1 


Tested in API 2 BTE STTG 



5.2.10.3 Method getSize 

Test Area Reference: Api_2_Bte_Gtsz. 

5.2.10.3.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getSizeO 

5.2.10.3.1.1 Normal execution 

• CRRNl : Returns the BER TLV size, this includes the tag and the length. 

5.2.10.3.1.2 Parameter errors 
No requirements. 

5.2.10.3.1.3 Context errors 
No requirements. 
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5.2.10.3.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.10.3.3 



Test area files 

Test_Api_2_Bte_Gtsz.java. 
Api_2_Bte_Gtsz_l .Java. 
api_2_bte_gtsz.cap. 

Test coverage 



CRR number 


Test case number 


1 


1,2,3,4,5,6 



5.2.10.3.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Get a BERTLVEditHandler using 

buildTLVHandler with type BER_EDIT_HANDLER 
and capacity 0x110 






1 


Fill the handler with BERTLV tag 0x01, data 

length 0x22 

Call getSizeO method 


Returns 0x24 




2 


Fill the handler with BERTLV tag 0x01, data 

length 0x7F 

Call getSizeO method 


Returns 0x81 




3 


Fill the handler with BERTLV tag 0x01, data 

length 0x80 

Call getSizeO method 


Returns 0x83 




4 


Fill the handler with BERTLV tag 0x01, data 

length OxFF 

Call getSizeO method 


Returns 0x1 02 




5 


Fill the handler with BERTLV tag 0x01, data 

length 0x100 

Call getSizeO method 


Returns 0x1 04 




6 


Fill the handler with BERTLV tag 0x01, data 

length 0x110 

Call getSizeO method 


Returns 0x1 14 





5.2.10.4 Method getLength 

Test Area Reference Api_2_Bte_Glen. 

5.2.10.4.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getLength () 

throws ToolkitException 

5.2.1 0.4.1 .1 Normal execution 

• CRRNl : returns the length in bytes of the TLV list. 

5.2.10.4.1.2 Parameter errors 
No requirements. 

5.2.10.4.1.3 Context errors 

• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AV AIL ABLE. 
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5.2.10.4.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.10.4.3 



Test area files 

Test_Api_2_Bte_Glen.j ava. 
Api_2_Bte_Glen_ 1 .j ava. 
api_2_bte_glen .c ap . 

Test coverage 



CRR number 


Test case number 


N1 


1,2,3,4,5,6 


C1 


Does not apply for BERTLVEdit Handler 



5.2.10.4.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Get a BERTLVEditHandler using 
buildTLVHandler with type 
BER_EDIT_HANDLER and capacity 0x100 and 
set its BER Tag to 0x01 






1 


Clear the handler 

getLength {) 


Result of getLengthQ is 




2 


Call the appendArrayO method with buffer 
length 9 

getLength ( ) 


Result of getLengthO is 9 




3 


Call the appendArrayO method, with buffer 
length = 253 

getLength {) 


Result of getLengthQ is 253 




4 


Build a 7Fh Handler and fill it with 
appendArrayO method 

getLength ( ) 


Result of getLengthO is 7Fh 




5 


Build a 80h Handler and fill it with 
appendArrayO method 

getLength ( ) 


Result of getLengthQ is 80h 




6 


Build a 100h Handler and fill it with 
appendArrayO method 

getLength {) 


Result of getLengthQ is 1 0Oh 





5.2.10.5 Method copy 

Test Area Reference Api_2_Bte_Copy. 



5.2.10.5.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

public short copy (byte [] dstBuffer, 
short dstOffset, 
short dstLength) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
ToolkitException 
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5.2.10.5.1.1 Normal execution 

• CRRNl: copies the Comprehension TLV list contained in the handler to the destination byte array. 

• CRRN2: returns dstOffset + dstLength. 

5.2.10.5.1.2 Parameter errors 

• CRRPl : if dstBuffer is null a NullPointerException is thrown. 

• CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative, 
an ArraylndexOutOfBoundsException is thrown. 

• CRRP3: if dstLength is grater than the length of the Comprehension TLV List, an instance of 
ToolkitException shall be thrown. The reason code shall be 
ToolkitException.OUT_OF_TLV_BOUND ARIES. 



5.2.10.5.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AV AIL ABLE. 



5.2.10.5.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.10.5.3 



Test area files 

Test_Api_2_Bte_Copy.j ava. 
Api_2_Bte_Copy _l.java. 
api_2_bte_copy.cap. 

Test coverage 



CRR number 


Test case number 


N1 


9, 11, 13 


N2 


8, 10, 12 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7 


CI 


Does not apply for BERTLVEdit 
Handler 



5.2.10.5.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Get a BERTLVEditHandler using 
buildTLVHandler with type 
BER_EDIT_HANDLER and capacity 0x100 and 
set its BER Tag to 0x01 






1 


NULL as parameter to dstBuffer 


NullPointerException is thrown 




2 


Call the appendArrayO method with 
81 03 01 41 42 82 02 81 43 








DstOffset > dstBuffer.length 

copy 

dstBuffer.length = 5 
dstOffset = 6 
dstLength = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


dstOffset < 

copy 

dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


4 


DstLength > dstBuffer.length 

copy 

dstBuffer.length = 5 
dstOffset = 
dstLength = 6 


Array 1 ndexOutOfBou ndsExceptio 
n is thrown 




5 


dstOffset + dstLength > dstBuffer.length 

copy 

dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


dstLength < 

copy 

dstBuffer.length = 5 
dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


dstLength > length of the Comprehension TLV 
list 

copy 

dstBuffer.length = 10 
dstOffset = 
dstLength = 10 


Tooll<itException.OUT OF TLV 
BOUNDARIES is thrown 




8 


Successful call, dstBuffer is the whole buffer 

copy 

dstBuffer.length = 9 
dstOffset = 
dstLength = 9 


Result of copyO is 9 




9 


Compare the buffer 


Result of arrayCompareO is 




10 


Successful call, dstBuffer is part of a buffer 

copy 

dstBuffer.length = 15 
dstOffset = 3 
dstLength = 9 


Result of copyO is 12 




11 


Compare the whole buffer 


Result of arrayCompareO is 




12 


Successful call, dstBuffer is part of a buffer 

copy 

dstBuffer.length = 15 
dstOffset = 3 
dstLength = 6 


Result of copyO is 9 




13 


Compare the whole buffer 


Result of arrayCompareO is 





5.2.10.6 Method findTLV 

Test Area Reference Api_2_Bte_Find. 

5.2.10.6.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte findTLV (byte tag, byte occurrence) 
throws ToolkitException 

5.2.10.6.1.1 Normal execution 

Looks for the indicated occurrence of a TLV element from the beginning of the TLV list (handler buffer): 

• CRRNl: the method is successful if the required occurrence exists then the corresponding TLV becomes 
current. 

• CRRN2: if the method is successful then it returns TLV_FOUND_CR_SET when Comprehension Required 
flag is set. 

• CRRN3: if the method is successful then it returns TLV_FOUND_CR_NOT_SET when Comprehension 
Required flag is not set. 

• CRRN4: if the required occurrence of the TLV element does not exist, the current TLV is no longer defined 
and TLV NOT FOUND is returned. 
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• CRRN5: The search method is comprehension required flag independent. 

5.2.10.6.1.2 Parameter errors 

• CRRP 1 : if an input parameter is not vaHd (e.g. occurrence = 0) an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException.BAD_INPUT_PARAMETER. 



5.2.10.6.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 



5.2.10.6.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.10.6.3 



Test area files 

Test_Api_2_Bte_Find.j ava. 
Api_2_Bte_Find_l .Java. 
api_2_bte_find.cap. 

Test coverage 



CRR number 


Test case number 


N1 


3,5 


N2 


2,4 


N3 


10, 11 


N4 


6, 7,8, 9 


N5 


12, 13 


P1 


1 


C1 


Does not apply for BERTLVEdit Handler 



5.2.10.6.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Get a BERTLVEditHandler using 
buildTLVHandler with type 
BER_EDIT_HANDLER and capacity 0x100 and 
set its BER Tag to 0x01 






1 


Initialize the handler with 
81 03 01 21 00 82 02 81 82 








Invalid input parameter 

findTLVO 
Occurrence = 


ToolkitException. BAD_INPUT_PA 
RAIVIETER is thrown 




2 


Call the initO method 








Search 1st TLV 

findTLVO 
Tag = Olh 
Occurrence = 1 


Result is TLV_FOUND_CR_SET 




3 


Call the getValueLengthO method 


Result is 03h 




4 


Search 2nd TLV 

findTLVO 
Tag = 02h 
Occurrence = 1 


Result is TLV_FOUND_CR_SET 




5 


Call the getValueLengthO method 


Result is 02h 




6 


Select a TLV (tag 02h) 








Search a wrong tag 

findTLVO 
Tag = 03h 
Occurrence = 1 


Result is TLV_NOT_FOUND 




7 


Call the getValueLengthO method 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown. 
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8 


Search a tag with wrong occurrence 

findTLVO 
Tag = Olh 
Occurrence = 2 


Result is TLV_NOT_FOUND 




9 


Call the getValueLengthO method 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown. 




10 


Append a TLV with tag=02h 








Search the TLV 

findTLVO 
Tag = 02h 
Occurrence = 2 


Result is 
TLV_FOUND_CR_NOT_SET 




11 


Append a TLV with tag=04h 








Search the TLV 

findTLVO 
Tag = 04h 
Occurrence = 1 


Result is 
TLV_FOUND_CR_NOT_SET 




12 


Search tag 81 h 

findTLVO 
Tag = 81h 
Occurrence = 1 


Result is TLV_FOUND_CR_SET 




13 


Search tag 84h 

findTLVO 
Tag = 84h 
Occurrence = 1 


Result is 
TLV_FOUND_CR_NOT_SET 





5.2.10.7 Method getValueLength 

Test Area Reference Api_2_Bte_Gvle. 

5.2.10.7.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getValueLengthO 

throws ToolkitException 



5.2.10.7.1.1 



Normal execution 



CRRN 1 : gets and returns the binary length of the value field for the last TLV element which has been found in 
the handler. 



5.2.10.7.1.2 
No requirements. 

5.2.10.7.1.3 



Parameter errors 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AV AIL ABLE. 

• CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException.UNAVAILABLE_ELEMENT. 



5.2.10.7.2 

Test Source: 
Test Applet: 
Cap File: 



Test area files 

Test_Api_2_Bte_Gvle.j ava. 
Api_2_Bte_Gvle_l .Java. 
api_2_bte_g vie . c ap . 
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5.2.10.7.3 



Test coverage 



CRR number 


Test case number 


N1 


2,3,4,5,6 


C1 


Does not apply for BERTLVEdit Handler 


C2 


1 



5.2.10.7.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Get a BERTLVEditHandler using 
buildTLVHandler with type 
BER_EDIT_HANDLER and capacity 0x100 and 
set its BER Tag to 0x01 






1 


Initialize the handler with 
81 03 01 21 00 82 02 81 82 








getValueLength ( ) 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown 




2 


Call the appendTLVO method 

tag = OD 
valueOffset = 
valueLength = 








Search TLV ODh (Text String TLV) 








getValueLength ( ) 


Result is OOh 




3 


Initialize the handler with 81 03 01 21 00 82 02 
81 02 OD 02 04 00 

length = 1 (+ dcs byte) 








Search TLV ODh (Text String TLV) 








getValueLength ( ) 


Result is 02h 




4 


Initialize the handler with 81 03 01 21 00 82 02 
81 02 0D7F04 00 00... 








Search TLV ODh (Text String TLV) 








getValueLength ( ) 


Result is 7Fh 




5 


Initialize the handler with 81 03 01 21 00 82 02 
81 02 OD 81 80 04 00 00... 








Search TLV ODh (Text String TLV) 








getValueLength ( ) 


Result is aOh 




6 


Initialize the handler with 81 03 01 21 00 82 02 
81 02 0D81 F1 04 00 00... 








Search TLV ODh (Text String TLV) 








getValueLength ( ) 


Result is F1h 





5.2.10.8 Method getValueByte 

Test Area Reference Api_2_Bte_Gvby. 

5.2.10.8.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte getValueByte (short valueOffset) 
throws ToolkitException 



5.2.10.8.1.1 



Normal execution 



• CRRNl: Gets a byte from the last TLV element which has been found in the handler and returns its value 

(1 byte). 
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5.2.10.8.1.2 



Parameter errors 



• CRRP 1 : if valueOffset is out of the current TLV an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException.OUT_OF_TLV_BOUND ARIES. 



5.2.10.8.1.3 



Context errors 



CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException.UNAVAILABLE_ELEMENT. 



5.2.10.8.2 

Test Source: 
Test Applet: 
Cap File: 



Test area files 

Test_Api_2_Bte_Gvby.j ava. 
Api_2_Bte_Gvby_l .Java. 
api_2_bte_gvby.cap. 



5.2.10.8.3 



Test coverage 



CRR number 


Test case number 


N1 


3, 4, 5, 6, 7, 8 


PI 


2 


CI 


Does not apply for BERTLVEdit Handler 


C2 


1 



5.2.10.8.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Get a BERTLVEditHandler using 
buildTLVHandler with type 
BER_EDIT_HANDLER and capacity 0x100 and 
set its BER Tag to 0x01 






1 


Initialize the handler with 
81 03 01 FF FE 82 02 81 FD 

type = FFh 
qualifier = FEh 
destination = FDh 








getValueByte(O) 


ToolkitException. UNAVAILABLE 
ELEIVIENT is thrown 




2 


Search TLV 01 h (Command Details TLV) 








getValueByte(3) 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




3 


Search TLV 01 h (Command Details TLV) 








getValueByte(2) 


Result is FEh (qualifier) 




4 


Search TLV 02h (Device Identities TLV) 








getValueByte(O) 


Result is 81 h (Source) 




5 


Initialize the handler with 81 03 01 21 00 82 02 
81 02 0D7F04 00 01 ... 7D 

Search TLV ODh (Text String TLV) 








getValueByte(7E) 


Result is 7Dh 




6 


Initialize the handler with 81 03 01 21 00 82 02 
81 02 0D81 80 04 00 01 ... 7E 

Search TLV ODh (Text String TLV) 








getValueByte(7E) 


Result is 7Dh 




7 


getValueByte(7F) 


Result is 7Eh 
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Initialize the handler with 81 03 01 21 00 82 02 
81 02 0D81 F1 04 00 01 ... EF 

Search TLV ODh (Text String TLV) 
getValueByte(FO) 



Result is EFh 



5.2.10.9 Method copyValue 

Test Area Reference Api_2_Bte_Cpyv. 
5.2.10.9.1 Conformance requirement 

The method with following header shall be compliant with its definition in the API. 

public short copyValue (short valueOffset, 

byte[] dstBuffer, 
short dstOffset, 
short dstLength) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException^ 
ToolkitException 

5.2.10.9.1.1 Normal execution 

• CRRNl: copies a part of the last TLV element which has been found, into a destination, buffer. 

• CRRN2: returns dstOffset + dstLength. 

5.2.10.9.1.2 Parameter errors 

• CRRP 1 : if dstBuffer is null NullPointerException is thrown. 

• CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative 
ArraylndexOutOfBoundsException is thrown. 

• CRRP3: if valueOffset is negative or valueOffset + dstLength > current TLV length, an instance of 
ToolkitException shall be thrown. The reason code shall be 
ToolkitException.OUT_OF_TLV_BOUND ARIES. 



5.2.10.9.1.3 



Context errors 



CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException.UNAVAILABLE_ELEMENT. 



5.2.10.9.2 

Test Source: 
Test Applet: 
Cap File: 



Test area files 

Test_Api_2_Bte_Cpyv.j ava. 
Api_2_Bte_Cpyv_l .Java. 
api_2_bte_cpyv.cap. 
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5.2.10.9.3 



Test coverage 



CRR number 


Test case number 


N1 


13,15 


N2 


12, 14 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7,8,9,10 


C1 


Does not apply for BERTLVEdit Handler 


C2 


11 



5.2.10.9.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Get a BERTLVEditHandler using 
buildTLVHandler with type 
BER_EDIT_HANDLER and capacity 0x100 and 
set its BER Tag to 0x01 






1 


Initialize the handler with 

81 03 01 21 00 82 02 81 82 

Select a TLV 








copyValueO with a null dstBuffer 


NullPointerException is thrown 




2 


Initialize the handler with 81 03 01 21 00 82 02 
81 02 OD 10 04 00 01 ... OE 

Select Text String TLV 








dstOffset > dstBuffer.length 

copyValue () 
dstBuffer.length = 5 
dstOffset = 6 
dstLength = 


Array 1 ndexOutOfBou ndsExceptio 
n is thrown 




3 


dstOffset < 

copyValue () 
dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


dstLength >dstBuffer.length 

copyValue () 
dstBuffer.length = 5 
dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + dstLength >dstBuffer.length 

copyValue () 
dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


Array 1 ndexOutOfBou ndsExceptio 
n is thrown 




6 


dstLength < 

copyValue () 
dstBuffer.length = 5 
dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Initialize the handler with 81 03 01 21 00 82 02 
81 02 OD 06 04 00 01 ...04 

Select Text String TLV 








valueOffset > Text String Length 

copyValue () 
valueOffset = 7 
dstBuffer.length = 15 
dstOffset = 
dstLength = 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


[Select Text String TLV] 

valueOffset < 
copyValue {) 
valueOffset = -1 
dstBuffer.length = 15 
dstOffset = 
dstLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


9 


[Select Text String TLV] 

dstLength > Text String length 
copyValue () 
valueOffset = 
dstBuffer. length = 15 
dstOffset = 
dstLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


[Select Text String TLV] 

valueOffset + dstLength > Text String 

length 

copyValue () 

valueOffset = 2 

dstBuffer. length = 15 

dstOffset = 

dstLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Initialize the handler with 
81 03 01 21 00 82 02 81 82 








copyValueO 


ToolkitException.UNAVAILABLE_ 
ELEMENT is thrown 




12 


Initialize the handler with 81 03 01 21 00 82 02 
81 02 0D11 04 00 01 ...OF 

Select Text String TLV 








Successful call 

copyValue () 
valueOffset = 
dstBuffer. length = 17 
dstOffset = 
dstLength = 17 


Result of copyValueO is 17 




13 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




14 


Initialize dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

copyValue () 
valueOffset = 2 
dstBuffer .length = 20 
dstOffset = 3 
dstLength = 12 


Result of copyValueO is 15 




15 


Compare buffer 

buffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 


Result is OOh 





5.2.10.10 Method compareValue 

Test Area Reference Api_2_Bte_Cprv. 

5.2.10.10.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte compareValue (short valueOffset, 

byte[] compareBuf fer, 
short compareOf f set, 
short compareLength) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
ToolkitException 
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5.2.1 0.1 0.1.1 Normal execution 
Compares the last found TLV element with a buffer: 

• CRRN 1 : returns if identical. 

• CRRN2: returns -1 if the first miscomparing byte in Comprehension TLV List is less than that in 
compareBuffer. 

• CRRN3: returns 1 if the first miscomparing byte in Comprehension TLV List is greater than that in 
compareBuffer. 

5.2.10.10.1.2 Parameter errors 

• CRRPl: if compareBuffer is null NullPointerException shall be thrown. 

• CRRP2: if compareOffset or compareLength or both would cause access outside array bounds, or if 
compareLength is negative ArraylndexOutOfBoundsException shall be thrown. 

• CRRP3: if valueOffset is negative or valueOffset + dstLength > current TLV length, an instance of 
ToolkitException shall be thrown. The reason code shall be 
ToolkitException.OUT_OF_TLV_BOUND ARIES. 



5.2.10.10.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AV AIL ABLE. 

• CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException.UNAVAILABLE_ELEMENT. 



5.2.10.10.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.10.10.3 



5.2.10.10.4 



Test area files 

Test_Api_2_Bte_Cprv.j ava. 
Api_2_Bte_Cprv_l .Java. 
api_2_bte_cprv.cap. 

Test coverage 



CRR number 


Test case number 


N1 


12, 15 


N2 


13, 16 


N3 


14, 17, 18 


PI 


1 


P2 


2,3,4,5,6 


P3 


7,8,9, 10 


C1 


Does not apply for BERTLVEdit Handler 


C2 


11 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Get a BERTLVEditHandler using 
buildTLVHandler with type 
BER_EDIT_HANDLER and capacity 0x100 and 
set its BER Tag to 0x01 






1 


Initialize the handler with 

81 03 01 21 00 82 02 81 02 

Select a TLV 








compareValueQ with a null compareBuffer 


NullPointerException is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


2 


Initialize the handler with 81 03 01 21 00 82 02 
81 02 OD 10 04 00 01 ... OE 

Select Text String TLV 








compareOffset > compareBuffer.length 

compareValue () 
compareBuffer.length = 5 
compareOffset = 6 
compareLength = 


Array 1 ndexOutOfBou ndsExceptio 
n is thrown 




3 


compareOffset < 

compareValue ( ) 
compareBuffer.length = 5 
compareOffset = -1 
compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


compareLength >compareBuffer.length 

compareValue () 
compareBuffer.length = 5 
compareOffset = 
compareLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


compareOffset + compareLength 
>compareBuffer.length 

compareValue ( ) 
compareBuffer.length = 5 
compareOffset = 3 
compareLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


compareLength < 

compareValue ( ) 

compareBuffer.length = 5 
compareOffset = 
compareLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Initialize the handler with 81 03 01 21 00 82 02 

81 02 OD 06 04 00 01 ...04 
Select Text String TLV 








valueOffset > Text String Length 

compareValue ( ) 
valueOffset = 7 
compareBuffer.length = 15 
compareOffset = 
compareLength = 


Tooll<itException.OUT OF TLV 
BOUNDARIES is thrown 




8 


[Select Text String TLV] 

valueOffset < 
compareValue ( ) 
valueOffset = -1 
compareBuffer.length = 15 
compareOffset = 
compareLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


[Select Text String TLV] 

compareLength > Text String length 
compareValue () 
valueOffset = 
compareBuffer.length = 15 
compareOffset = 
compareLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


[Select Text String TLV] 

valueOffset + compareLength > Text String 

length 

compareValue () 

valueOffset = 2 

compareBuffer.length = 15 

compareOffset = 

compareLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Initialize the handler with 
81 03 01 21 00 82 02 81 82 








compareValueO 


ToolkitException.UNAVAILABLE_ 
ELEMENT is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


12 


Initialize the handler with 81 03 01 21 00 82 02 
81 02 0D11 04 00 01 ...OF 

Select Text String TLV 








Initialize compareBuffer 

compareBuffer = 
04 00 01 ... OF 








Compare buffers 

compareValue () 
valueOffset = 
compareOf f set = 
compareLength = 17 


Result is OOh 




13 


Initialize compareBuffer 

compareBuffer = 
04 00 01 02 03 

04 05 06 07 08 

05 OA OB OC OD 
OE 10 








Compare buffers with same parameters 


Result is -1 




14 


Initialize compareBuffer 

compareBuffer = 
03 00 01 ... OF 








Compare buffers with same parameters 


Result is +1 




15 


Initialize compareBuffer 

compareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 








Compare buffers 

compareValue () 
valueOffset = 2 
compareOf f set = 3 
compareLength = 12 


Result is OOh 




16 


Initialize compareBuffer 

compareBuffer = 
55 55 55 02 01 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 








Compare buffers with same parameters 


Result is -1 




17 


Initialize compareBuffer 

compareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OA OD 
55 55 55 55 55 








Compare buffers with same parameters 


Result is +1 




18 


Initialize compareBuffer 

compareBuffer = 
55 55 55 99 03 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 








Compare buffers with same parameters 


Result is +1 
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5.2.1 0.1 1 Method findAndCopyValue(byte tag, byteQ dstBuffer, short valueOffset) 

Test Area Reference Api_2_Bte_Facyb_Bs. 

5.2.10.11.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short f indAndCopyValue (byte tag, 

byte[] dstBuffer, 
short dstOffset) 
throws Java . lang . NullPointerException, 

Java .lang . Array IndexOutOfBoundsExcept ion, 
ToolkitException 



5.2.10.11.1.1 



Normal execution 



• CRRN 1 : looks for the first occurrence of a TLV element from the beginning of a TLV list and copy its value 
into a destination buffer. 

• CRRN2: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current 
TLV is no longer defined. 

• CRRN3: if the method is successful then the corresponding TLV becomes current and dstOffset + length of 
the copied value is returned. 

• CRRN4: The search method is comprehension required flag independent. 

5.2.10.11.1.2 Parameter errors 

• CRRP 1 : if dstBuffer is null NullPointerException shall be thrown. 

• CRRP2: if dstOffset would cause access outside array bounds ArraylndexOutOfBoundsException shall be 
thrown. 



5.2.10.11.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException,HANDLER_NOT_AVAILABLE. 

5.2.10.11.2 Test area files 

Test Source: Test_Api_2_Bte_Facyb_Bs.java. 
Test Applet: Api_2_Bte_Facyb_Bs_l.java. 

Cap File: api_2_bte_facyb_bs.cap. 



5.2.10.11.3 



Test coverage 



CRR number 


Test case number 


N1 


8, 10, 12 


N2 


6 


N3 


7, 9, 11 


N4 


13, 14, 15, 16 


P1 


1 


P2 


2, 3, 4, 5 


C1 


Does not apply for BERTLVEdit Handler 
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5.2.10.11.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Get a BERTLVEditHandler using 
buildTLVHandler with type 
BER_EDIT_HANDLER and capacity 0x100 and 
set its BER Tag to 0x01 






1 


Initialize the handler with 
81 03 01 21 00 82 02 81 02 








FIndAndCopyValueO with a null dstBuffer 


NullPointerException is thrown 




2 


Initialize the handler with 81 03 01 21 00 82 02 
81 02 OD 10 04 00 01 ... OE 








dstOffset > dstBuffer.length 

f IndAndCopyValue () 
tag = ODh 

dstBuffer.length = 20 
dstOffset = 21 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


dstOffset < 

f indAndCopyValue () 
dstBuffer.length = 20 
dstOffset = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


length > dstBuffer.length 

f IndAndCopyValue () 
dstBuffer.length = 15 
dstOffset = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


DstOffset + length >dstBuffer.length 

f IndAndCopyValue () 
DstBuffer.length = 20 
DstOffset = 5 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


Initialize the handler with 81 03 01 21 00 82 02 
81 02 0D11 04 00 01 ...OF 








Select a TLV (tag 02h) 








fIndAndCopyValueO 

tag = 03h 


Tooll<itException. UNAVAILABLE 
ELEMENT is thrown 






Call the getValueLengthO method 


Tooll<itException. UNAVAILABLE 
ELEIVIENT is thrown. 




7 


Initialize the handler with 81 03 01 21 00 82 02 
81 02 0D11 04 00 01 ...OF 








Successful call 

f IndAndCopyValue () 
Tag = ODh 

DstBuffer.length = 17 
DstOffset = 


Result of findAndcopyValueO is 
17 




8 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




9 


Initialize dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

f indAndCopyValue () 
dstBuffer.length = 20 
dstOffset = 2 


Result of findAndcopyValueO is 
19 




10 


Compare buffer 

buffer = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 


Result is OOh 
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Id 


Description 


API Expectation 


APDU Expectation 


11 


Initialize the handler with 81 03 01 21 00 82 02 
81 02 0D11 04 00 01 ...OF 








append a 2nd Text String TLV 








Successful call 

findAndCopyValue () 
tag = ODh 

dstBuffer. length = 17 
dstOffset = 


Result of fincJAndcopyValueO is 
17 




12 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




13 


Initialize the handler with 81 03 01 21 00 82 02 
81 02 0D11 04 00 01 ...OF 








Successful call (with tag 8Dh) 

findAndCopyValue () 
tag = 8Dh 

dstBuffer .length = 17 
dstOffset = 


Result of finclAndcopyValueO is 
17 




14 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




15 


Append tag OFh 

buffer = 00 01 ... OF 








Successful call (with tag 8Fh) 

findAndCopyValue () 
tag = 8Fh 

dstBuffer .length = 16 
dstOffset = 


Result of fincJAndcopyValueO is 
16 




16 


Compare buffer 

buffer = 00 01 ... OF 


Result is OOh 





5.2.1 0.1 2 Method findAndCopyValue(byte tag, byte occurrence, short valueOffset, 
byte[] dstBuffer, short dstOffset, short dstLength) 

Test Area Reference Api_2_Bte_Facybbs_Bss. 



5.2.10.12.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

public short findAndCopyValue (byte tag, 

byte occurrence, 
short valueOffset, 
byte[] dstBuffer, 
short dstOffset, 
short dstLength) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
ToolkitException 



5.2.10.12.1.1 



Normal execution 



• CRRNl: looks for the indicated occurrence of a TLV element from the beginning of a TLV list and copy its 
value into a destination buffer. 

• CRRN2: if no TLV element is found, the UN AV AILABLE_ELEMENT exception is thrown and the current 
TLV is no longer defined. 

• CRRN3: if the method is successful then the corresponding TLV becomes current and dstOffset + dstLength is 
returned. 

• CRRN4: The search method is comprehension required flag independent. 
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5.2.10.12.1.2 Parameter errors 

• CRRP 1 : if dstBuffer is null NullPointerException shall be thrown. 

• CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative 
ArraylndexOutOfBoundsException shall be thrown. 

• CRRP3: if valueOffset is negative or valueOffset + dstLength > current TLV length, an instance of 
ToolkitException shall be thrown. The reason code shall be 
ToolkitException.OUT_OF_TLV_BOUND ARIES. 

• CRRP4: if an input parameter is not valid (e.g. occurrence = 0) an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException.BAD_INPUT_PARAMETER . 



5.2.10.12.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 



5.2.10.12.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.10.12.3 



Test area files 

Test_Api_2_Bte_Facybbs_Bss.java. 

Api_2_Bte_Facybbs_Bss_Ljava. 

api_2_bte_facybbs_bss.cap. 

Test coverage 



CRR number 


Test case number 


N1 


13, 15, 17, 19 


N2 


11 


N3 


12, 14, 16, 18 


N4 


20,21,22,23 


PI 


1 


P2 


2,3,4,5,6 


P3 


7,8,9, 10 


P4 


24 


C1 


Does not apply for BERTLVEdit Handler 



5.2.10.12.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Get a BERTLVEditHandler using 
buildTLVHandler with type 
BER_EDIT_HANDLER and capacity 0x100 and 
set its BER Tag to 0x01 






1 


Initialize the handler with 
81 03 01 21 00 82 02 81 82 








flndAndCopyValueQ with a null dstBuffer 


NullPointerException is thrown 




2 


Initialize the handler with 81 03 01 21 00 82 02 
81 02 OD 10 04 00 01 ... OE 








dstOffset > dstBuffer.length 

f indAndCopyValue () 

tag = ODh, occurrence = 1 

valueOffset = 

dstBuffer.length = 5 

dstOffset = 6 

dstLength = 


ArraylndexOutOfBoundsExceptio 
n is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


3 


dstOffset < 

f IndAndCopyValue () 
dstBuffer . length = 5 
dstOffset = -1 
dstLength = 1 


Array 1 ndexOutOfBou ndsExceptio 
n is thrown 




4 


dstLength >dstBuffer.length 

f IndAndCopyValue {) 
dstBuffer . length = 5 
dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + dstLength >dstBuffer.length 

f IndAndCopyValue () 
dstBuffer . length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


dstLength < 

f IndAndCopyValue () 
dstBuffer . length = 5 
dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Initialize the handler with 81 03 01 21 00 82 02 
81 02 OD 06 04 00 01 ...04 








valueOffset > Text String Length 

f IndAndCopyValue () 

tag = ODh, occurrence = 1 

valueOffset = 7 

dstBuffer. length = 15 

dstOffset = 

dstLength = 


Tooll<itException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

f IndAndCopyValue () 
valueOffset = -1 
dstBuffer. length = 15 
dstOffset = 
dstLength = 1 


Tooll<itException.OUT OF TLV 
BOUNDARIES is thrown 




9 


dstLength > Text String length 

f IndAndCopyValue () 
valueOffset = 
dstBuffer. length = 15 
dstOffset = 
dstLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


valueOffset + dstLength > Text String length 

f IndAndCopyValue () 
valueOffset = 2 
dstBuffer. length = 15 
dstOffset = 
dstLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Initialize the handler with 81 03 01 21 00 82 02 
81 02 0D11 04 00 01 ...OF 








Select a TLV (tag 02h) 








findAndCopyValueO 

f IndAndCopyValue () 
tag = ODh 
occurrence = 2 


ToolkitException.UNAVAILABLE_ 
ELEMENT is thrown 






Call the getValueLengthO method 


ToolkitException. UNAVAILABLE 
ELEIVIENT is thrown. 




12 


Initialize the handler with 81 03 01 21 00 82 02 
81 02 0D11 04 00 01 ...OF 








Successful call 

f IndAndCopyValue () 

tag = ODh, occurrence = 1 

valueOffset = 

dstBuffer. length = 17 

dstOffset = 

dstLength = 17 


Result of findAndCopyValueQ is 
17 




13 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 
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Id 


Description 


API Expectation 


APDU Expectation 


14 


Initialize dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

f IndAndCopyValue () 

tag = ODh, occurrence = 1 

valueOffset = 2 

dstBuffer .length = 20 

dstOffset = 3 

dstLength = 12 


Result of fincJAndcopyValueO is 
15 




15 


Compare buffer 

buffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 


Result is OOh 




16 


Append a Text String TLV 

f IndAndCopyValue () 

tag = OD 

buffer = 00 11 22 33 44 55 (no specific 

DCS byte) 








Successful call 

f IndAndCopyValue () 

tag = ODh, occurrence = 1 

valueOffset = 

dstBuffer .length = 17 

dstOffset = 

dstLength = 17 


Result of findAndCopyValueO is 
17 




17 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




18 


Successful call 

f IndAndCopyValue () 

tag = ODh, occurrence = 2 

valueOffset = 

dstBuffer . length = 6 

dstOffset = 

dstLength = 6 


Result of findAndCopyValueQ is 6 




19 


Compare buffer 

buffer = 00 11 22 33 44 55 


Result is OOh 




20 


Initialize the handler with 81 03 01 21 00 82 02 
81 02 0D11 04 00 01 ...OF 








Successful call (with tag 8Dh) 

f IndAndCopyValue () 
tag = 8Dh 
occurrence = 1 
valueOffset = 
dstBuffer .length = 17 
dstOffset = 
dstLength = 17 


Result of findAndcopyValueO is 
17 




21 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




22 


Append tag OFh 

buffer = 00 01 ... OF 








Successful call (with tag 8Fh) 

f IndAndCopyValue () 
tag = 8Fh 
occurrence = 1 
valueOffset = 
dstBuffer . length = 16 
dstOffset = 
dstLength =16 


Result of findAndcopyValueO is 
16 




23 


Compare buffer 

buffer = 00 01 ... OF 


Result is OOh 




24 


Invalid parameter 

f IndAndCopyValue () 
occurrence = 


ToolkitException.BAD_INPUT_PA 
RAIVIETER is thrown 
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5.2.10.13 Method findAndCompareValue(byte tag, byteQ compareBuffer, short 
compareOffset) 

Test Area Reference Api_2_Bte_Facrb_Bs. 

5.2.10.13.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte f indAndCompareValue (byte tag, 

byte[] compareBuffer, 
short compareOffset) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
ToolkitException 

5.2.1 0.1 3.1 .1 Normal execution 

Looks for the first occurrence of a TLV element from beginning of a TLV list and compare its value with a buffer: 

• CRRN 1 : if no TLV element is found, the UN AV AILABLE_ELEMENT exception is thrown and the current 
TLV is no longer defined. 

• CRRN2: if the method is successful then the corresponding TLV becomes current. 

• CRRN3: if identical returns 0. 

• CRRN4: if the first miscomparing byte in Comprehension TLV is less than that in compareBuffer returns -I. 

• CRRN5: if the first miscomparing byte in Comprehension TLV is greater than that in compareBuffer returns 1. 

• CRRN6: The search method is comprehension required flag independent. 

5.2.10.13.1.2 Parameter errors 

• CRRPl: if compareBuffer is null NullPointerException shall be thrown. 

• CRRP2: if compareOffset would cause access outside array bounds ArraylndexOutOfBoundsException shall 
be thrown. 

5.2.10.13.1.3 Context errors 

• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

5.2.10.13.2 Test area files 

Test Source: Test_Api_2_Bte_Facrb_Bs.java. 
Test Applet: Api_2_Bte_Facrb_Bs_Ljava. 

Cap File: api_2_bte_facrb_bs.cap. 
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5.2.10.13.3 



Test coverage 



CRR number 


Test case number 


N1 


6 


N2 


8 


N3 


7, 11, 12, 17 


N4 


9, 13 


N5 


10, 14 


N6 


15, 16 


P1 


1 


P2 


2, 3, 4, 5 


C1 


Does not apply for BERTLVEdit Handler 



5.2.10.13.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Get a BERTLVEditHandler using 
buildTLVHandler with type 
BER_EDIT_HANDLER and capacity 0x100 and 
set its BER Tag to 0x01 






1 


Initialize the handler with 
81 03 01 21 00 82 02 81 82 








findAndCompareValueO with a null dstBuffer 


NullPointerException is thrown 




2 


Initialize the handler with 81 03 01 21 00 82 02 
81 02 OD 10 04 00 01 ... OE 








compareOffset > compareBuffer.length 

f indAndCompareValue () 
tag = ODh 

compareBuffer.length = 20 
compareOffset = 21 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


compareOffset < 

f IndAndCompareValue () 
compareBuffer.length = 20 
compareOffset = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


length > compareBuffer.length 

f indAndCompareValue () 
compareBuffer.length = 15 
compareOffset = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


compareOffset + length > 

f indAndCompareValue () 
compareBuf f er . length 
compareBuffer.length = 20 
compareOffset = 5 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


Initialize the handler with 81 03 01 21 00 82 02 
81 02 0D11 04 00 01 ...OF 








Select a TLV (tag 02h) 








findAndCompareValueO 

tag = 03h 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown 






Call the getValueLengthO method 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown. 




7 


Initialize the handler with 81 03 01 21 00 82 02 
81 02 0D11 04 00 01 ...OF 








Initialize compareBuffer 

compareBuf fer = 
04 00 01 ... OF 








Compare buffers 

f IndAndCompareValue () 
tag = ODh 
compareOffset = 


Result is OOh 




8 


Verify current TLV 

getValueLength ( ) 


Result is 17 
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Id 


Description 


API Expectation 


APDU Expectation 


9 


Initialize compareBuffer 

compareBuffer = 
04 00 01 ... 10 








Compare buffers with same parameters 


Result is -1 




10 


Initialize compareBuffer 

compareBuffer = 
03 00 01 ... OF 








Compare buffers with same parameters 


Result is +1 




11 


Initialize compareBuffer 

compareBuffer = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 








Compare buffers 

f IndAndCompareValue () 
compareOf f set = 2 


Result is OOh 




12 


append a Text String TLV 

tag = ODh 

buffer = 00 11 22 33 44 55 








Initialize compareBuffer 

compareBuffer = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 








Compare buffers 

f IndAndCompareValue () 
compareOf f set = 2 


Result is OOh 




13 


Initialize compareBuffer 

compareBuffer = 
55 55 04 01 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 








Compare buffers 

f IndAndCompareValue () 
compareOf f set = 2 


Result is -1 




14 


Initialize compareBuffer 

compareBuffer = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OD 10 55 








Compare buffers 

f IndAndCompareValue () 
compareOf f set = 2 


Result is +1 




15 


Initialize the handler with 81 03 01 21 00 82 02 
81 02 0D11 04 00 01 ...OF 








Initialize compareBuffer 

CompareBuffer = 04 00 01 ... OF 








Successful call (with tag 8Dh) 

f IndAndCompareValue () 
tag = 8Dh 

compareBuf fer . length = 17 
compareOf f set = 


Result is OOh 




16 


Append tag OFh 

buffer = 00 01 ... OF 








Initialize compareBuffer 

compareBuffer = 00 01 ... OF 








Successful call (with tag 8Fh) 

f IndAndCompareValue () 
tag = 8Fh 

compareBuf fer . length = 16 
compareOf f set = 


Result is OOh 




17 


Initialize compareBuffer 
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Id 


Description 


API Expectation 


APDU Expectation 




compareBuffer = 00 99 01 03 ... OF 








Successful call (with tag 8Fh) 

f indAndCompareValue () 
tag = 8Fh 

compareBuffer . length =16 
compareOf f set = 


Result is +1 





5.2.1 0.1 4 Method findAndCompareValue(byte tag, byte occurrence, short valueOffset, 
byte[] compareBuffer, short compareOffset, short compareLength) 

Test Area Reference Api_2_Bte_Facrbbs_Bss. 

5.2.10.14.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte f IndAndCompareValue (byte tag, 

byte occurrence, 
short valueOffset, 
byte[] compareBuffer, 
short compareOffset, 
compareLength) 
throws Java . lang . NullPointerException, 

Java .lang . Array I ndexOut Of Bounds Except ion, 
ToolkitException 



5.2.10.14.1.1 



Normal execution 



Looks for the indicated occurrence of a TLV element from the beginning of a TLV list and compare its value with a 
buffer: 

• CRRN 1 : if no TLV element is found, the UN AV AILABLE_ELEMENT exception is thrown and the current 
TLV is no longer defined. 

• CRRN2: if the method is successful then the corresponding TLV becomes current. 

• CRRN3: if identical is returned. 

• CRRN4: if the first miscomparing byte in Comprehension TLV is less than that in compareBuffer -1 is 
returned. 

• CRRN5: if the first miscomparing byte in Comprehension TLV is greater than that in compareBuffer 1 is 
returned. 

• CRRN6: The search method is comprehension required flag independent. 

5.2.10.14.1.2 Parameter errors 

• CRRPl: if compareBuffer is null NullPointerException shall be thrown. 

• CRRP2: if compareOffset or compareLength or both would cause access outside array bounds, or if 
compareLength is negative ArraylndexOutOfBoundsException shall be thrown. 

• CRRP3: if valueOffset is negative or valueOffset + dstLength > current TLV length, an instance of 
ToolkitException shall be thrown. The reason code shall be 
ToolkitException.OUT_OF_TLV_BOUND ARIES. 

• CRRP4: if an input parameter is not valid (e.g. occurrence = 0) an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException.BAD_INPUT_PARAMETER. 
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5.2.10.14.1.3 



Context errors 



CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 



5.2.10.14.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.10.14.3 



Test area files 

Test_Api_2_Bte_Facrbbs_Bss.java. 
Api_2_Bte_Facrbbs_Bss_l .Java. 
api_2_bte_facrbbs_bss.cap. 

Test coverage 



CRR number 


Test case number 


N1 


12 


N2 


14 


N3 


13, 17,20,21 


N4 


15, 18,22 


N5 


16, 19 


N6 


23,24 


PI 


1 


P2 


2, 3, 4, 5, 6 


PS 


7,8,9, 10 


P4 


11 


CI 


Does not apply for BERTLVEdit Handler 



5.2.10.14.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Get a BERTLVEditHandler using 
buildTLVHandler with type 
BER_EDIT_HANDLER and capacity 0x100 and 
set its BER Tag to 0x01 






1 


Initialize the handler with 
81 03 01 21 00 82 02 81 82 








findAndCompareValueO with a null 
compareBuffer 


NullPointerException is thrown 




2 


Initialize the handler with 81 03 01 21 00 82 02 
81 02 OD 10 04 00 01 ... OE 








compareOffset > compareBuffer.length 

f IndAndCompareValue () 
tag = ODh, occurrence = 1 
valueOffset = 
compareBuffer.length = 5 
compareOffset = 6 
compareLength = 


Array 1 ndexOutOfBou ndsExceptio 
n is thrown 




3 


compareOffset < 

f IndAndCompareValue () 
compareBuffer.length = 5 
compareOffset = -1 
compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


compareLength >compareBuffer.length 

f indAndCompareValue ( ) 
compareBuffer.length = 5 
compareOffset = 
compareLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


compareOffset + compareLength 
>compareBuffer.length 

f IndAndCompareValue () 
compareBuffer.length = 5 
compareOffset = 3 
compareLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


6 


compareLength < 

f IndAndCompareValue () 
compareBuff er . length = 5 
compareOf f set = 
compareLength = -1 


Array 1 ndexOutOfBou ndsExceptio 
n is thrown 




7 


Initialize the handler with 81 03 01 21 00 82 02 
81 02 OD 06 04 00 01 ...04 








valueOffset > Text String Length 

f IndAndCompareValue () 
tag = ODh, occurrence = 1 
valueOffset = 7 
compareBuff er . length = 15 
compareOf fset = 
compareLength = 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

f IndAndCompareValue () 
valueOffset = -1 
compareBuff er . length = 15 
compareOf fset = 
compareLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


compareLength > Text String length 

f IndAndCompareValue () 
valueOffset = 
compareBuff er . length = 15 
compareOf fset = 
compareLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


valueOffset + compareLength > Text String 
length 

f IndAndCompareValue () 
valueOffset = 2 
compareBuffer . length = 15 
compareOf fset = 
compareLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Invalid parameter 

f IndAndCompareValue () 
occurrence = 


ToolkitException.BAD_INPUT_PA 
RAMETER is thrown 




12 


Initialize the handler with 81 03 01 21 00 82 02 
81 02 0D11 04 00 01 ...OF 








Select a TLV (tag 02h) 








findAndCompareValueQ 

tag = ODh 
occurrence = 2 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown 






Call the getValueLengthO method 


ToolkitException. UNAVAILABLE, 
ELEMENT is thrown. 




13 


Initialize the handler with 81 03 01 21 00 82 02 
81 02 0D11 04 00 01 ...OF 








Initialize compareBuffer 

compareBuffer = 
04 00 01 ... OF 








findAndCompareValueQ 

tag = ODh, occurrence = 1 
valueOffset = 
compareOf fset = 
compareLength = 17 


Result is OOh 




14 


Verify current TLV 

getValueLength ( ) 


Result is 17 




15 


Initialize compareBuffer 

compareBuffer = 

04 00 01 02 03 04 05 06 07 08 09 OA OB OC 

OD OE 10 








Compare buffers with same parameters 


Result is -1 
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Id 


Description 


API Expectation 


APDU Expectation 


16 


Initialize compareBuffer 

compareBuf f er = 
03 00 01 ... OF 








Compare buffers with same parameters 


Result is +1 




17 


Initialize compareBuffer 

compareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 








Compare buffers 

f IndAndCompareValue () 
valueOffset = 2 
compareOf f set = 3 
compareLength = 12 


Result is OOh 




18 


Initialize compareBuffer 

compareBuffer = 
55 55 55 02 01 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 








Compare buffers with same parameters 


Result is -1 




19 


Initialize compareBuffer 

compareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OA OD 
55 55 55 55 55 








Compare buffers with same parameters 


Result is +1 




20 


append a Text String TLV 

tag = ODh 

buffer = 00 11 22 33 44 55 








Initialize compareBuffer 

compareBuffer = 
04 00 01 ... OF 








findAndCompareValueQ 

tag = ODh, occurrence = 1 
valueOffset = 
compareOf fset = 
compareLength = 17 


Result is OOh 




21 


Initialize compareBuffer 

compareBuffer = 
00 11 22 33 44 55 








findAndCompareValueQ 

tag = ODh, occurrence = 2 
valueOffset = 
compareOf fset = 
compareLength = 6 


Result is OOh 




22 


Initialize compareBuffer 

compareBuffer = 
00 11 22 33 44 66 








findAndCompareValueQ 

tag = ODh, occurrence = 2 
valueOffset = 
compareOf fset = 
compareLength = 6 


Result is -1 
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Id 


Description 


API Expectation 


APDU Expectation 


23 


Initialize the handler with 81 03 01 21 00 82 02 
81 02 0D11 04 00 01 ...OF 








Initialize compareBuffer 

CompareBuf fer = 04 00 01 ... OF 








Successful call (with tag 8Dh) 

f IndAndCompareValue () 
tag = 8Dh, occurrence = 1 
valueOffset = 
CompareBuf fer . length = 17 
compareOf f set = 
compareLength = 17 


Result is OOh 




24 


Append tag OFh 

buffer = 00 01 ... OF 








Initialize compareBuffer 

compareBuffer = 00 01 ... OF 








Successful call (with tag 8Fh) 

f IndAndCompareValue () 
tag = 8Fh, occurrence = 1 
valueOffset = 
CompareBuf fer . length = 16 
compareOf f set = 
compareLength = 16 


Result is OOh 




25 


Initialize compareBuffer 

compareBuffer =0099 02 ... OF 

findAndCompareValueQ 

tag = ODh, occurrence = 1 
valueOffset = 
compareOf f set = 
compareLength = 17 


Result is +1 





5.2.10.15 Method getCapacity 

Test Area Reference: Api_2_Bte_Gcap. 

5.2.10.15.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte getCapacity ( ) 

5.2.10.15.1.1 Normal execution 

• CRRNl: The method shall return the maximum size of the Comprehension TLV list managed by the handler. 



5.2.10.15.1.2 
No requirements 

5.2.10.15.1.3 
No requirements 

5.2.10.15.2 

Test Source: 
Test Applet: 
Cap File: 



Parameter errors 
Context errors 
Test area files 

Test_Api_2_Bte_Gcap.java. 
Api_2_Bte_Gcap_l.java. 
api_2_bte_gcap . cap . 
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5.2.10.15.3 



Test coverage 



CRR number 


Test case number 


N1 


1 



5.2.10.15.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Get a BERTLVEditHandler using 
buildTLVHandler with type 

BER_EDIT_HANDLER and capacity 0x10 and set 
its BER Tag to 0x01 






1 


1- The applet calls getCapacity () on the 
BERTLVEditHandler 

2- The applet fills the handler with the 
maximum capacity, using appendTLV ( ) method 

3- The applet calls clear () on the 
BERTLVEdit handler 

4- The applet fills the handler with the 
maximum capacity plus one, using 
appendTLV method 


1- No exception is thrown, the 
capacity shall be 0x10 

2- No exception is thrown 

3- No exception is thrown 

4- HANDLER_OVERFLOW 
exception is thrown 





5.2.1 0.1 6 Method getValueShort 

Test Area Reference: Api_2_Bte_Gvsh. 

5.2.10.16.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getValueShort (short valueOffset) 
throws ToolkitException 



5.2.10.16.1.1 



Normal execution 



CRRNl: Gets a short from the last TLV element which has been found in the handler and returns its value 
(1 short). 



5.2.10.16.1.2 



Parameter errors 



CRRPl: if valueOffset is out of the current TLV an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException.OUT_OF_TLV_BOUND ARIES. 



5.2.10.16.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AV AIL ABLE. 

• CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException.UNAVAILABLE_ELEMENT. 

5.2.10.16.2 Test area files 

Specific triggering: None. 

Test Source: Test_Api_2_Bte_Gvsh.java. 
Test Applet: Api_2_Bte_Gvsh_Ljava. 

Cap File: api_2_bte_gvsh.cap. 
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5.2.10.16.3 



Test coverage 



CRR number 


Test case number 


N1 


3, 4, 5, 6, 7, 8 


P1 


2 


C1 


Does not apply for BERTLVEdit Handler 


C2 


1 



5.2.10.16.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Get a BERTLVEditHandler using 
buildTLVHandler with type 
BER_EDIT_HANDLER and capacity 0x100 and 
set its BER Tag to 0x01 






1 


Initialize the handler 
with 81 03 01 FF FE 82 02 81 FD 








getValueShort(O) 


ToolkitException.UNAVAlLABLE_ 
ELEMENT is thrown 




2 


Search TLV 01 h (Command Details TLV) 








getValueShort(3) 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




3 


Search TLV 01 h (Command Details TLV) 








getValueShort(l) 


Result is FFh Feh (type, qualifier) 




4 


Search TLV 02h (Device Identities TLV) 








getValueShort(O) 


Result is 81 h FDh (Source, 
Destination) 




5 


Initialize the handler with 81 03 01 21 00 82 02 

81 02 0D7F04 00 01 ... 7D 

Search TLV ODh (Text String TLV) 








getValueShort(7D) 


Result is 7Ch 7Dh 




6 


Initialize the handler with 81 03 01 21 00 82 02 

81 02 0D81 80 04 00 01 ... 7E 

Search TLV ODh (Text String TLV) 








getValueShort(7D) 


Result is 7Ch 7Dh 




7 


getValueShort(7E) 


Result is 7Dh 7Eh 




8 


Initialize the handler with 81 03 01 21 00 82 02 

81 02 0D81 F1 04 00 01 ... EF 

Search TLV ODh (Text String TLV) 








getValueShort(EF) 


Result is Eeh Efh 





5.2.10.17 Method appendArray 

Test Area Reference: Api_2_Bte_Apda. 



5.2.10.17.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

Public void appendArray (byte [ ] buffer, 

short offset, 
short length) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
ToolkitException 
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5.2.1 0.1 7.1 .1 Normal execution 

• CRRN 1 : appends a buffer into the Edithandler buffer. 

• CRRN2: a successful append does not modify the TLV selected. 

5.2.10.17.1.2 Parameter errors 

• CRRPl: if buffer is null, a java.lang.NullPointerException is thrown. 

• CRRP2: if offset or length or both would cause access outside the array bounds, or if length is negative, a 
java.lang.ArraylndexOutOfBoundsException is thrown. 



5.2.10.17.1.3 



Context errors 



• CRRC 1 : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW. 

• CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE. 



5.2.10.17.2 

Test Source: 
Test Applet: 
Cap File: 



Test area files 

Test_Api_2_Bte_Apda.j ava. 
Api_2_Bte_Apda _l.java. 
api_2_bte_apda.cap. 



5.2.10.17.3 Test coverage 



CRR number 


Test case number 


N1 


9, 10, 11, 12 


N2 


8 


P1 


1 


P2 


2,3,4,5,6 


C1 


7 


C2 


Does not apply for BERTLVEdit Handler 



5.2.10.17.4 



Test procedure 



id 


Description 


API Expectation 


APDU Expectation 





Get a BERTLVEditHandler using 
buildTLVHandler with type 
BER_EDIT_HANDLER and capacity 0x100 and 
set its BER Tag to 0x01 






1 


Null buffer 

appendArray () 


NullPointerException Is thrown 




2 


Offset > buffer.length 

appendArray ( ) 
buffer.length = 5 
offset = 6 
length = 


ArraylndexOutOfBoundsExceptIo 
n Is thrown 




3 


Offset < 

appendArray () 
buffer.length = 5 
offset = -1 
length = 1 


ArraylndexOutOfBoundsExceptIo 
n Is thrown 




4 


length > buffer.length 

appendArray ( ) 
buffer.length = 5 
offset = 
length = 6 


ArraylndexOutOfBoundsExceptIo 
n Is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 





Get a BERTLVEditHandler using 
buildTLVHandler with type 
BER_EDIT_HANDLER and capacity 0x100 and 
set its BER Tag to 0x01 






5 


offset + length > buffer.length 

appendArray () 
buffer.length = 5 
offset = 3 
length = 3 


Array 1 ndexOutOfBou ndsExceptio 
n is thrown 




6 


length < 

appendArray () 
buffer.length = 5 
offset = 
length = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Handler overflow exception 

appendArray ( ) 

buffer.length = getCapacity ( ) +1 

offset = 

length = getCapacity {) +1 


Tooll<itException. HANDLER OVE 
RFLOW is thrown 




8 


Initialize handler with 
81 03 01 00 00 82 02 81 00 








Select Command Details TLV 








Successful call 

appendArray () 
buffer = FF FE ... F8 
offset = 
length = 8 








Verify Current TLV: Call getValueLength() 


Result is 03h 




9 


Clear the handler 








Successful call 

buffer = FF FE ... F8 
offset = 
length = 8 








Call copyO method 








Compare the arrays 

compareBuf fer = FF FE ... F8 


Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 




10 


Successful call 

appendArray () 
buffer = 00 01 ... 07 
offset = 2 
length = 6 








Call copyO method 








Compare the arrays 

compareBuffer = FF FE ... F8 02 03 ... 07 


Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 




11 


Successful call 

appendArray ( ) 
buffer = 11 22 ... 88 
offset = 2 
length = 4 








Call copyO method 








Compare the arrays 

compareBuffer = FF FE ... F8 02 03 ... 07 33 
44 55 66 


Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 




12 


Clear the handler 








Successful call 

appendArray ( ) 
buffer = 00 01 ... FC 
offset = 
length = 253 








Call getLengthO method 


result = 253 






Call copyO method 








Compare handler 

compareBuffer = 00 01 ... FC 


Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 
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5.2.1 0.1 8 Method appendTLV(byte tag, byte value) 

Test Area Reference: Api_2_Bte_Aptlbb. 

5.2.10.18.1 Conformance requirement 

The method with following header shall be compliant to its definition in the APT 

public void appendTLV (byte tag, byte value) 
throws ToolkitException 

5.2.1 0.1 8.1.1 Normal execution 

• CRRNl: Appends a TLV element to the current TLV list (1-byte element). 

• CRRN2: A successful append does not modify the TLV selected. 

5.2.10.18.1.2 Parameter errors 
No requirements. 

5.2.10.18.1.3 Context errors 

• CRRC 1 : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW. 

• CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE. 



5.2.10.18.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.10.18.3 



Test area files 

Test_Api_2_Bte_Aptlbb.java. 
Api_2_Bte_Aptlbb_l .Java. 
api_2_bte_aptlbb.cap. 

Test coverage 



CRR number 


Test case number 


N1 


3,4,5 


N2 


2 


C1 


1 


C2 


Does not apply for BERTLVEdit Handler 



5.2.10.18.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Get a BERTLVEditHandler using 
buildTLVHandler with type 
BER_EDIT_HANDLER and capacity 0x100 and 
set its BER Tag to 0x01 






1 


Call appendArrayO 

length = getCapacity ( ) -1 








Handler Overflow exception: 
Call the appendTLVO method 


ToolkitException. HANDLER OVE 
RFLOW is thrown 




2 


Initialize handler with 
81 03 01 00 00 82 02 81 00 








Select Command Details TLV 








Call the appendTLVO method 








Verify Current TLV: Call getValueLength() 


Result is 03h 
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Id 


Description 


API Expectation 


APDU Expectation 


3 


Clear the handler 








Successful call 

appendTLVO 
tag = 84h 
value = OOh 








Call copyO method 








Compare the arrays 

compareBuffer = 84 01 00 


Result of 

javacard.framework.Util.arrayCom 
pareO is OOh 




4 


Successful call 

appendTLV () 
tag = Olh 
value = FEh 








Call copvO method 








Compare the arrays 

compareBuffer = 84 01 00 01 01 FE 


Result of 

javacard.framework.Util.arrayCom 
pareO is OOh 




5 


Clear the handler 
Call appendArrayO 

length = 250 

buffer = 00 81 F7 03 04 ... F9 

Successful call 

appendTLVO 
tag = 84h 
value = OOh 

Call getLengthO method 
Call copyO method 
Compare the array 

compareBuffer = 00 81 F7 03 04 ... F9 84 01 
00 


result = 253 

Result of 

javacard.framework.Util.arrayCom 
pareO is OOh 





5.2.1 0.1 9 Method appendTLV(byte tag, byte valuel , byte value2) 

Test Area Reference: Api_2_Bte_Aptlbbb. 

5.2.10.19.1 Conformance requirements 

The method with following header shall be compliant to its definition in the API. 

public void appendTLV (byte tag, 

byte value) 
throws ToolkitException 

5.2.10.19.1.1 Normal execution 

• CRRNl: Appends a TLV element to the current TLV list (2-byte element). 

• CRRN2: A successful append does not modify the TLV selected. 

5.2.10.19.1.2 Parameter errors 
No requirements. 

5.2.10.19.1.3 Context errors 

• CRRC 1 : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW. 

• CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE. 
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5.2.10.19.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.10.19.3 



Test area files 

Test_Api_2_Bte_Aptlbbb.java. 
Api_2_Bte_Aptlbbb_l .Java. 
api_2_bte_aptlbbb . c ap . 

Test coverage 



CRR number 


Test case number 


N1 


3,4,5 


N2 


2 


C1 


1 


C2 


Does not apply for BERTLVEdit Handler 



5.2.10.19.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Get a BERTLVEditHandler using 
buildTLVHandler with type 
BER_EDIT_HANDLER and capacity 0x100 and 
set its BER Tag to 0x01 






1 


Call the appendArrayO 

length = getCapacity () -1 








Handler Overflow exception: 
Call the appendTLVO method 


ToolkitException. HANDLER OVE 
RFLOW is thrown 




2 


Initialize handler with 
81 03 01 00 00 82 02 81 00 








Select Command Details TLV 








Call the appendTLVO method 








Verify Current TLV: Call getValueLength() 


Result is 03h 




3 


Clear the handler 








Successful call 

appendTLV () 
tag = 84h 
valuel = OOh 
value2 = Olh 








Call copyO method 








Compare the arrays 

compareBuf fer = 84 02 00 01 


Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 




4 


Successful call 

appendTLVO 
tag = Olh 
valuel = FEh 
value2 = FDh 








Call copyO method 








Compare the arrays 

compareBuffer = 84 02 00 01 01 02 FE FD 


Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 




5 


Clear the handler 
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Call appendArrayO 

length = 249 

buffer = 00 81 F6 03 04 ... F8 








Successful call 

appendTLV () 
tag = 84h 
valuel = OOh 
value2 = Olh 








Call getLengthO method 


result = 253 






Call copyO method 








Compare handler 

compareBuf fer = 00 81 F6 03 04 ... F8 84 02 
00 01 


Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 





5.2.1 0.20 Method appendTLV(byte tag, byte[ ] value, short valueoffset, short 
valuelength) 

Test Area Reference: Api_2_Bte_Aptlb_Bss. 

5.2.10.20.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void appendTLV (byte tag, 

byte [ ] value, 
short valueoffset, 
short valuelength) 
throws Java . lang . NullPointerException, 

Java .lang . Array I ndexOut Of Bounds Except ion, 
ToolkitException 

5.2.1 0.20.1 .1 Normal execution 

• CRRNl: Appends a TLV element to the current TLV list (byte-array element). 

• CRRN2: A successful append does not modify the TLV selected. 

5.2.10.20.1.2 Parameter errors 

• CRRPl: if value is null, a java.lang.NullPointerException is thrown. 

• CRRP2: if valueoffset or valuelength or both would cause access outside the array bounds, or if length is 
negative, a java.lang.ArraylndexOutOfBoundsException is thrown. 



5.2.10.20.1.3 



Context errors 



CRRC 1 : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW. 

CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE. 

CRRC3: if valuelength is greater than 255, a ToolkitException is thrown with reason code 
BAD INPUT PARAMETER. 



5.2.10.20.2 

Test Source: 
Test Applet: 
Cap File: 



Test area files 

Test_Api_2_Bte_Aptlb_Bss.java. 
Api_2_Bte_Aptlb_Bss_l .Java. 
api_2_bte_aptlb_bss.cap. 
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5.2.10.20.3 



Test coverage 



CRR number 


Test case number 


N1 


10, 11, 12, 13, 14 


N2 


9 


P1 


1 


P2 


2, 3, 4, 5, 6 


C1 


7 


C2 


Does not apply for BERTLVEdit Handler 


C3 


8 



5.2.10.20.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Get a BERTLVEditHandler using 
buildTLVHandler with type 
BER_EDIT_HANDLER and capacity 0x100 and 
set its BER Tag to 0x01 






1 


Null value 

appendTLV () 


NullPointerException is thrown 




2 


valueOffset > value.length 

appendTLV 
value . length = 5 
valueOffset = 6 
valueLength = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


valueOffset < 

appendTLV 
value.length = 5 
valueOffset = -1 
valueLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


valueLength > value.length 

appendTLV 
value.length = 5 
valueOffset = 
valueLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


valueOffset + valueLength > value.length 

appendTLV 
value.length = 5 
valueOffset = 3 
valueLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


valueLength < 

appendTLV () 
value.length = 5 
valueOffset = 
valueLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Handler overflow exception 

Call the appendArray ( ) method, length = 

getCapacity {) -1 

appendTLV 

value.length = 254 

valueOffset = 

valueLength = 254 


ToolkitException.HANDLER_OVE 
RFLOW is thrown 




8 


Bad parameter exception 

Clear the handler 
appendTLV 
value.length = 256 
valueOffset = 
valueLength = 256 


ToolkitException.BAD_INPUT_PA 
RAIVIETER is thrown 




9 


Initialize handler with 
81 03 01 00 00 82 02 81 00 








Select Command Details TLV 








Successful call 

appendTLV 

tag = 04 

value = FF FE ... F8 

valueOffset = 

valueLength = 8 








Verify Current TLV: Call getValueLength() 


Result is 03h 




10 


Clear the handler 








Successful call 

appendTLV () 
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Id 


Description 


API Expectation 


APDU Expectation 




tag = 04 

value = FF FE ... F8 
valueOffset = 
valueLength = 8 








Call copyO method 








Compare the arrays 

compareBuf fer = 04 08 FF FE ... F8 


Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 




11 


Successful call 

appendTLV () 

tag = 85h 

value = 00 01 ... 07 

valueOffset = 2 

valueLength = 6 








Call copyO method 








Compare the arrays 

compareBuffer = 04 08 FF FE ... F8 85 06 02 
03 ... 07 


Result of 

javacard.framework.Util.arrayCom 
pareO is OOh 




12 


Successful call 

appendTLV () 

tag = 01 

value = 11 22 ... 88 

valueOffset = 2 

valueLength = 4 








Call copyO method 








Compare the arrays 

compareBuffer = 04 08 FF FE ... F8 85 06 02 
03 ... 07 01 04 33 44 55 66 


Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 




13 


Clear the handler 








Successful call 

appendTLV () 

tag = 04 

value = 00 01 ... 7F 

valueOffset = 

valueLength = 80h 








Call copyO method 








Compare the arrays 

compareBuffer = 04 81 80 00 01. ..7F 


Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 




14 


Clear the handler 

Successful call 

appendTLV () 

tag = 04 

value = 00 01 ... F9 

valueOffset = 

valueLength = 250 

Call getLengthO method 

Call copyO method 
Compare handler 

compareBuffer = 04 81 FA 00 01. ..F9 


result = 253 

Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 
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5.2.1 0.21 Method appendTLV(byte tag, byte valuel , byte[ ] value2, short value2offset, 
short value2length) 

Test Area Reference: Api_2_Bte_Aptlbb_Bss. 



5.2.10.21.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

public void appendTLV (byte tag, 

byte valuel 
byte [ ] value2, 
short value2of f set , 
short value21ength) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
ToolkitException 

5.2.1 0.21 .1 .1 Normal execution 

• CRRNl: Appends a TLV element to the current TLV list (1 byte and a byte-array element). 

• CRRN2: A successful append does not modify the TLV selected. 

5.2.1 0.21 .1 .2 Parameter errors 

• CRRPl: if value2 is null, a Java. lang. NullPointerException is thrown. 

• CRRP2: if value2offset or value21ength or both would cause access outside the array bounds, or if length is 
negative, a java.lang.ArraylndexOutOfBoundsException is thrown. 



5.2.10.21.1.3 



Context errors 



• CRRC 1 : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW. 

• CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE. 

• CRRC3: if valuelength is greater than 255, a ToolkitException is thrown with reason code 
BAD_INPUT_PARAMETER. 

5.2.10.21.2 Test area files 

Test Source: Test_Api_2_Bte_Aptlbb_Bss.java. 
Test Applet: Api_2_Bte_Aptlbb_Bss_l.java. 

Cap File: api_2_bte_aptlbb_bss.cap. 



5.2.10.21.3 



Test coverage 



CRR number 


Test case number 


N1 


10, 11, 12, 13, 14 


N2 


9 


P1 


1 


P2 


2,3,4,5,6 


C1 


7 


C2 


Does not apply for BERTLVEdit Handler 


C3 


8 
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5.2.10.21.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Get a BERTLVEditHandler using 
buildTLVHandler with type 
BER_EDIT_HANDLER and capacity 0x100 and 
set its BER Tag to 0x01 






1 


Null value2 

appendTLVO 


NullPointerException is thrown 




2 


value20ffset > value2.length 

appendTLV () 
value2 . length = 5 
value20ffset = 6 
value2Length = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


value20ffset < 

appendTLVO 
value2 . length = 5 
value20ffset = -1 
value2Length = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


value2Length > value2.length 

appendTLVO 
value2 . length = 5 
value20ffset = 
value2Length = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


value20ffset + value2Length > value2.length 

appendTLVO 
value2 . length = 5 
value20ffset = 3 
value2Length = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


value2Length < 

appendTLVO 
value2 . length = 5 
value20ffset = 
value2Length = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Handler overflow exception 

Call the appendArray ( ) method, length = 

getCapacity () -1 

appendTLV ( ) 

value2. length = 254 

value20ffset = 

value2Length = 254 


Tooll<itException.HANDLER_OVE 
RFLOW is thrown 




8 


Bad parameter exception 

Clear the handler 
appendTLVO 
value2. length = 256 
value20ffset = 
value2Length = 256 


ToolkitException.BAD_INPUT_PA 
RAIVIETER is thrown 




9 


initialize liandler with 
81 03 01 00 00 82 02 81 00 








Select Command Details TLV 








Successful call 

appendTLVO 

tag = 04 

valuel = 05 

value2 = FF FE ... F8 

value20ffset = 

value2Length = 8 








Verify Current TLV: Call getValueLengtli() 


Result is 03h 




10 


Clear the handler 








Successful call 

appendTLVO 

tag = 04 

valuel = 05 

value2 = FF FE ... F8 

value20ffset = 

value2Length = 8 








Call copyO method 








Compare the arrays 

CompareBuffer = 04 09 05 FF FE ... F8 


Result of 

javacard.framework.Util.arrayCom 
pareO is OOh 
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Id 


Description 


API Expectation 


APDU Expectation 


11 


Successful call 

appendTLV () 
tag = 85h 
valuel = 55h 
value2 = 00 01 ... 07 
value20ffset = 2 
value2Length = 6 








Call copyO method 








Compare the arrays 

compareBuf fer = 

04 09 05 FF FE ... F8 

85 07 55 02 03 ... 07 


Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 




12 


Successful call 

appendTLVO 
tag = 01 
valuel = 44h 
value2 = 11 22 ... 88 
value20ffset = 2 
value2Length = 4 








Call copvO method 








Compare the arrays 

CompareBuf fer = 
04 09 05 FF FE ... F8 
85 07 55 02 03 ... 07 
01 05 44 33 44 55 66 


Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 




13 


Clear the handler 








Successful call 

appendTLV () 
tag = 04 
valuel = 00 
value2 = 01 ... 7F 
value20ffset = 
value2Length = 7Fh 








Call copyO method 








Compare the arrays 

compareBuffer = 04 81 80 00 01. ..7F 


Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 




14 


Clear the handler 








Successful call 

appendTLVO 
tag = 04 
valuel = 00 
value2 = 01 ... F9 
value20ffset = 
value2Length = 249 








Call getLengthO method 


result = 253 






Call copyO method 








Compare handler 

compareBuffer = 04 81 FA 00 01. ..F9 


Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 





5.2.1 0.22 Method appendTLV(byte tag, byte valuel , short value2) 

Test Area Reference: Api_2_Bte_Aptlbbs. 

5.2.10.22.1 Conformance requirements 

The method with following header shall be compliant to its definition in the API. 

public void appendTLV (byte tag, 

byte valuel, 
short value2) 
throws ToolkitException 
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5.2.1 0.22.1 .1 Normal execution 

• CRRNl: Appends a TLV element to the current TLV list (3-byte element(l -byte, 1 -short)). 

• CRRN2: A successful append does not modify the TLV selected. 

5.2.1 0.22.1 .2 Parameter errors 
No requirements 

5.2.1 0.22.1 .3 Context errors 

• CRRC 1 : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW 

• CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE 

5.2.10.22.2 Test area files 

Specific triggering: Unrecognized Envelope: 

Test Source: Test_Api_2_Bte_Aptlbbs.java. 
Test Applet: Api_2_Bte_Aptlbbs_l.java. 

Cap File: api_2_bte_aptlbbs.cap. 



5.2.10.22.3 



Test coverage 



CRR number 


Test case number 


N1 


3,4,5 


N2 


2 


C1 


1 


C2 


Does not apply for BERTLVEdit Handler 



5.2.10.22.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Get a BERTLVEditHandler using 
buildTLVHandler with type 
BER_EDIT_HANDLER and capacity 0x100 and 
set its BER Tag to 0x01 






1 


Call the appendArrayO 
length = getCapacity()-1 








Handler Overflow exception: 
Call the appendTLVO method 


ToolkitException. HANDLER_OVE 
RFLOW is thrown 




2 


Initialize handler with 
81 03 01 00 00 82 02 81 00 








Select Command Details TLV 








Call the appendTLVO method 








Verify Current TLV: Call getValueLength() 


Result is 03h 




3 


Clear the handler 








Successful call 

appendTLVO 
tag = 84h 
valuel = OOh 

value2 = 01h02h 








Call copyO method 








Compare the arrays 
compareBuffer = 84 03 00 01 02 


Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 
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Id 


Description 


API Expectation 


APDU Expectation 


4 


Successful call 

appendTLV () 
tag = Olh 
valuel = FEh 
value2 = FDh FCh 








Call copyO method 








Compare the arrays 

compareBuffer = 84 03 00 01 02 01 03 FE FD 

FC 


Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 




5 


Clear the handler 








Call appendArrayO 

length = 248 

buffer = 00 81 F5 03 04 ... F7 








Successful call 

appendTLVO 
tag = 84h 
valuel = OOh 
value2 = Olh 02h 








Call getLengthO method 


result = 253 






Call copyO method 








Compare handler 

compareBuffer = 00 81 F5 03 04 ... F7 84 03 00 

0102 


Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 





5.2.1 0.23 Method appendTLV(byte tag, short value) 

Test Area Reference: Api_2_Bte_Aptlbs. 

5.2.10.23.1 Conformance requirements 

The method with following header shall be compliant to its definition in the API. 

public void appendTLV (byte tag, 

short value) 
throws ToolkitException 

5.2.1 0.23.1 .1 Normal execution 

• CRRNl: Appends a TLV element to the current TLV list (2-byte or 1-short element). 

• CRRN2: A successful append does not modify the TLV selected. 

5.2.1 0.23.1 .2 Parameter errors 
No requirements 

5.2.10.23.1.3 Context errors 

• CRRC 1 : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW. 

• CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE. 

5.2.10.23.2 Test area files 

Specific triggering: Unrecognized Envelope: 

Test Source: Test_Api_2_Bte_Aptlbs.java. 
Test Applet: Api_2_Bte_Aptlbs_l.java. 

Cap File: api_2_bte_aptlbs.cap. 
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5.2.10.23.3 



Test coverage 



CRR number 


Test case number 


N1 


3,4,5 


N2 


2 


C1 


1 


C2 


Does not apply for BERTLVEdit Handler 



5.2.10.23.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Get a BERTLVEditHandler using 
buildTLVHandler with type 
BER_EDIT_HANDLER and capacity 0x100 and 
set its BER Tag to 0x01 






1 


Call appendArrayO 

length = getCapacity ( ) -1 








Handler Overflow exception: 
Call the appendTLVO method 


ToolkitException.HANDLER_OVE 
RFLOW is thrown 




2 


Initialize handler with 
81 03 01 00 00 82 02 81 00 








Select Command Details TLV 








Call the appendTLVO method 








Verify Current TLV: Call getValueLength() 


Result is 03h 




3 


Clear the handler 








Successful call 

appendTLVO 
tag = 84h 
value = OOh Olh 








Call copyO method 








Compare the arrays 
compareBuffer = 84 02 00 01 


Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 




4 


Successful call 

appendTLV () 
tag = Olh 
value = FEh FFh 








Call copyO method 








Compare the arrays 
compareBuffer = 84 02 00 01 01 02 FE FF 


Result of 

javacard.framework.Util.arrayConn 
pare() is OOh 




5 


Clear the handler 








Call appendArrayO 

length = 249 

buffer = 00 81 F6 03 04... F8 








Successful call 

appendTLV () 
tag = 84h 
value = OOh Olh 








Call getLengthO method 


result = 253 






Call copyO method 








Compare the array 

compareBuffer = 00 81 F6 03 04 ... F8 84 02 00 

01 


Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 
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5.2.1 0.24 Method appendTLV(byte tag, short valuel , short value2) 

Test Area Reference: Api_2_Bte_Aptlbss. 

5.2.10.24.1 Conformance requirements 

The method with following header shall be compliant to its definition in the API. 

public void appendTLV (byte tag, 

short valuel, 
short value2) 
throws ToolkitException 

5.2.10.24.1.1 Normal execution 

• CRRNl: Appends a TLV element to the current TLV list (4-byte element(2-short)). 

• CRRN2: A successful append does not modify the TLV selected. 



5.2.10.24.1.2 
No requirements 

5.2.10.24.1.3 



Parameter errors 



Context errors 



• CRRC 1 : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW. 

• CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE. 

5.2.10.24.2 Test area files 

Specific triggering: Unrecognized Envelope: 

Test Source: Test_Api_2_Bte_Aptlbss.java. 
Test Applet: Api_2_Bte_Aptlbss_l.java. 

Cap File: api_2_bte_aptlbss.cap. 



5.2.10.24.3 



Test coverage 



CRR number 


Test case number 


N1 


3,4,5 


N2 


2 


C1 


1 


C2 


Does not apply for BERTLVEdit Handler 



5.2.10.24.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Get a BERTLVEditHandler using 
buildTLVHandler with type 
BER_EDIT_HANDLER and capacity 0x100 and 
set its BER Tag to 0x01 






1 


Call the appendArrayO 

length = getCapacity ( ) -1 

Handler Overflow exception: 
Call the appendlLVO method 


ToolkitException. HANDLER OVE 
RFLOW is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


2 


Initialize handler with 

81 03 01 00 00 82 02 81 00 

Select Command Details TLV 

Call the appendTLVO method 

Verify Current TLV: Call getValueLength() 


Result is 03h 




3 


Clear the handler 
Successful call 

appendTLV () 
tag = 84h 
valuel = OOh Olh 
value2 = 02h 03h 

Call copyO method 

Compare the arrays 

compareBuffer = 84 04 00 01 02 03 


Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 




4 


Successful call 

appendTLVO 
tag = Olh 
valuel = FEh FDh 
value2 = FCh FBh 

Call copyO method 

Compare the arrays 

compareBuffer = 84 04 00 01 02 03 01 04 FE FD 

FCFB 


Result of 

javacard.framework.Util.arrayCom 
pareO is OOh 




5 


Clear the handler 
Call appendArrayO 

length = 247 

buffer = 00 81 F4 03 04 ... F6 

Successful call 

appendTLVO 
tag = 84h 
valuel = OOh Olh 
value2 = 02h 03h 

Call getLengthO method 

Call copyO method 

Compare handler 

compareBuffer = 00 81 F4 03 04 ... F6 84 04 00 

01 02 03 


result = 253 

Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 





5.2.1 0.25 Method appendTLV(byte tag, byte[] valuel , short valuel Offset, short 
valuel Length, byte[] value2, short value20ffset, short value2Length) 

Test Area Reference: Api_2_Bte_Aptlb_Bss_Bss. 

5.2.10.25.1 Conformance requirements 

The method with following header shall be compliant to its definition in the API. 

public void appendTLV (byte tag, 

byte [ ] valuel, 
short valuelOf f set, 
short valuelLength, 
byte [ ] value2, 
short value20f f set, 
short value2Length) 
throws Java . lang . NullPointerException, 

Java .lang . Array IndexOutOfBoundsExcept ion, 
ToolkitException 

5.2.10.25.1.1 Normal execution 

• CRRNl: Appends a TLV element to the current TLV list (2 byte arrays format). 

• CRRN2: A successful append does not modify the TLV selected. 
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5.2.10.25.1.2 
No requirements. 

5.2.10.25.1.3 



Parameter errors 



Context errors 



CRRC 1 : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW. 

CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE. 

CRRC3: If valuelLength or value2Length is greater than 255, a ToolkitException is thrown with reason code 
BAD_INPUT_PARAMETER. 

CRRC4: If valuel or value2 is null, a NullPointerException is thrown. 

CRRC5: If valuelOffset or valuelLength or both would cause access outside valuel array bounds, or if 
valuelLength is negative, an ArraylndexOutOfBoundsException is thrown. 

CRRC6: If value20ffset or value2Length or both would cause access outside value2 array bounds, or if 
value2Length is negative, an ArraylndexOutOfBoundsException is thrown. 



5.2.10.25.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.10.25.3 



Test area files 

Test_Api_2_Bte_Aptlb_Bss_Bss.java. 
Api_2_Bte_Aptlb_Bss_Bss_l .Java. 
api_2_bte_aptlb_bss_bss.cap. 

Test coverage 



CRR number 


Test case number 


N1 


18, 19,20,21 


N2 


17 


P1 


1,2 


P2 


3,4,5,6,7 


P3 


8,9, 10, 11, 12 


C1 


13 


C2 


Does not apply for BERTLVEdit Handler 


C3 


14, 15 



5.2.10.25.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Get a BERTLVEditHandler using 
buildTLVHandler with type 
BER_EDIT_HANDLER and capacity 0x100 and 
set its BER Tag to 0x01 






1 


Null valuel 

appendTLVO 


NullPointerException is thrown 




2 


Null value2 

appendTLVO 


NullPointerException is thrown 




3 


Valuel Offset > valuel .length 

appendTLV () 
valuel . length = 5 
valuelOffset = 5 
valuelLength = 1 
value2 . length = 5 
value20ffset = 
value2Length = 1 


Array 1 ndexOutOfBou ndsExceptio 
n is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


4 


ValuelOffset <0 

appendTLV () 
valuel . length = 5 
valuelOffset = -1 
valuelLength = 1 
value2 . length = 5 
value20ffset = 
value2Length = 1 


Array 1 ndexOutOfBou ndsExceptio 
n is thrown 




5 


ValuelLength > valuel .length 

appendTLV () 
valuel . length = 5 
valuelOffset = 
valuelLength = 6 
value2 . length = 5 
value20ffset = 
value2Length = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


ValuelOffset + valuelLength > valuel .length 

appendTLVO 
Valuel . length = 5 
valuelOffset = 3 
valuelLength = 3 
value2 . length = 5 
value20ffset = 
value2Length = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Valuel Length <0 

appendTLVO 
valuel . length = 5 
valuelOffset = 
valuelLength = -1 
value2 . length = 5 
value20ffset = 
value2Length = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




8 


Value20ffset > value2.length 

appendTLVO 
valuel . length = 5 
valuelOffset = 
valuelLength = 1 
value2 . length = 5 
value20ffset = 5 
value2Length = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




9 


Value20ffset < 

appendTLVO 
valuel . length = 5 
valuelOffset = 
valuelLength = 1 
value2 . length = 5 
value20ffset = -1 
value2Length = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




10 


Value2Length > value2.length 

appendTLV () 
valuel . length = 5 
valuelOffset = 
valuelLength = 1 
value2 . length = 5 
value20ffset = 
value2Length = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




11 


Value20ffset + value2Length > value2.length 

appendTLV () 
valuel . length = 5 
valuelOffset = 
valuelLength = 1 
Value2. length = 5 
Value20ffset = 3 
Value2Length = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




12 


Value2Length < 

appendTLVO 
valuel . length = 5 
valuelOffset = 
valuelLength = 1 
value2 . length = 5 
value20ffset = 
value2Length = -1 


Array 1 ndexOutOfBou ndsExceptio 
n is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


13 


Handler overflow exception 

Call the appendArray ( ) method, length = 

getCapacity () -1 

appendTLV () 

Valuel. length = 256 

ValuelOffset = 

ValuelLength = 253 

Value2. length = 256 

Value20ffset = 

Value2Length = 1 


ToolkitException.HANDLER_OVE 
RFLOW is thrown 




14 


Bad parameter exception 

Clear the handler 
appendTLVO 
Valuel. length = 256 
ValuelOffset = 
ValuelLength = 256 
Value2 .length = 256 
Value20ffset = 
Value2Length = 1 


ToolkitException.BAD_INPUT_PA 
RAMETER is thrown 




15 


Bad parameter exception 

appendTLV () 
Valuel .length = 256 
ValuelOffset = 
ValuelLength = 1 
Value2. length = 256 
Value20ffset = 
Value2Length = 256 


Tooll<itException.BAD_INPUT_PA 
RAIVIETER is thrown 




16 


Clear the handler, append the handler with 
TLVs: 

81 03 11 22 33 

82 02 99 77 

Select Command Details TLV 






17 


Successful call 

appendTLVO 
tag = 04 

valuel = FF FE ... F8 
valuelOffset = 
valuelLength = 8 
value2 = F7 F6 ... FO 
value20ffset = 
value2Length = 8 

Verify Current TLV: Call getValueLength() 
Clear the handler 


Result is 03h 




18 


Successful call 

appendTLV () 
tag = 04 

valuel = FF FE ... F8 
valuelOffset = 
valuelLength = 8 
value2 = F7 F6 ... FO 
value20ffset = 
value2Length = 8 

Call copyO method 

Compare handler 

CompareBuffer = 04 10 FF FE ... FO 


Result is 00 




19 


Successful call 

appendTLVO 
tag = 85h 

valuel = 00 01 ... 07 
valuelOffset = 2 
valuelLength = 6 
value2 = 08 09 ... OF 
value20ffset = 2 
value2Length = 6 

Call copyO method 

Compare handler 

compareBuffer = 04 10 FF FE ... FO 85 OC 02 03 

04 05 06 07 OA OB OC OD OE OF 


Result is 00 
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Id 


Description 


API Expectation 


APDU Expectation 


20 


Successful call 

appendTLV () 
tag = 01 

valuel = 11 22 ... 88 
valuelOffset = 2 
valuelLength = 4 
value2 = 99 AA ... FF 00 
value20ffset = 2 
value2Length = 4 

Call copyO method 

Compare handler 

compareBuffer = 04 10 FF FE ... FO 85 OC 02 03 

04 05 06 07 OA OB OC OD OE OF 01 08 33 44 55 

66 BB CC DD EE 

Clear the handler 


Result is 00 




21 


Successful call 

appendTLV () 
tag = 04 

valuel = 00 01 ... 7F 
valuelOffset = 
valuelLength = 80h 
value2 = 80 81 ... FC 
value20ffset = 
value2Length = 7Dh 

Call copyO method 

Compare handler 

compareBuffer = 04 81 FD 00 01 ...FC 


Result is 00 





5.2.10.26 Method clear 

Test Area Reference: Api_2_Bte_Cler. 

5.2.10.26.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void clear () 

throws ToolkitException 

5.2.1 0.26.1 .1 Normal execution 

• CRRN 1 : Clears the TLV list of an EditHandler. 

• CRRN2: Resets the current TLV selected. 



5.2.10.26.1.2 
No requirements. 

5.2.10.26.1.3 



Parameter errors 



Context errors 



• CRRC 1 : if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER NOT AVAILABLE. 



5.2.10.26.2 

Test Source: 
Test Applet: 
Cap File: 



Test area files 

Test_Api_2_Bte_Cler.j ava 
Api_2_Bte_Cler_l .Java 
api_2_bte_cler.cap 
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5.2.10.26.3 



Test coverage 



CRR number 


Test case number 


N1 


1 


N2 


2 


C1 


Does not apply for BERTLVEdit Handler 



5.2.10.26.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Get a BERTLVEditHandler using 
buildTLVHandler with type 
BER_EDIT_HANDLER and capacity 
0x100 and set its BER Tag to 
0x01 






1 


Initialize the handler with 
81 03 01 00 00 82 02 81 00 

Select Command Details TLV 
Call the getLengthO method 


Result of getLengthO Is not null 






Clear the handler 

Call the getLengthO method 


Result of getLengthO Is 




2 


Call the getValueLengthO 
method 


ToolkltExceptlon.UNAVAILABLE_ELEMENT 
Is thrown 





5.2.11 Interface BERTLVViewHandler 

Tests are done in inheriting interfaces BERTLVEditHandler and envelopeHandler. 

5.2.12 Class EnvelopeHandlerSystem 
5.2.12.1 Method getlheHandler 

Test Area Reference: Api_2_Ehs_Gthd. 

5.2.12.1.1 Conformance requirements 

The method with following header shall be compliant to its definition in the API. 

public static EnvelopeHandler getTheHandler ( ) 

throws ToolkitException 



5.2.12.1.1.1 



Normal execution 



CRRNl: The method shall return the single system instance of the class implementing the EnvelopeHandler 
interface. 

CRRN2: The EnvelopeHandler is a Temporary JCRE Entry Point Object (see Javacard 2.2.1 Runtime 
Environment (JCRE) Specification [3]). 



5.2.12.1.1.2 
No requirements. 

5.2.12.1.1.3 



Parameter errors 



Context errors 



CRRCl: The method shall thrown ToolkitException.HANDLER_NOT_AVAILABLE if the handler is not 
available. 
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5.2.12.1.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.12.1.3 



Test area files 

Test_Api_2_Ehs_Gthd.j ava. 
Api_2_Ehs_Gthd_ 1 .j ava. 
api_2_ehs_gthd.cap. 

Test coverage 



CRR number 


Test case number 


N1 


1,2,3 


N2 


checked in CAT Runtime Environment: Cre Api Hepo (Test case 1 and 2) 


C1 


checl<ed in CAT Runtime Environment: Cre_IVIIia_Enhd (Test case 1) 



5.2.12.1.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call GetTheHandler {) method twice 


The returned objects shall be the 
same 




2 


Verify that getTheHandler ( ) method returns 
an EnvelopeHandler . getTheHandler ( ) 


The reference returned shall be an 

object implementing the 

EnvelopeHandler interface (check 

cast) 




3 


Verify the returned value is not null 


The reference returned shall not be 
null. 





5.2.13 Class EnvelopeResponseHandlerSystem 
5.2.13.1 Method getTheHandler 

Test Area Reference: Api_2_Ers_Gthd. 

5.2.13.1.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public static EnvelopeResponseHandler getTheHandler ( ) 

throws ToolkitException 



5.2.13.1.1.1 



Normal execution 



• CRRNl: The method shall return the single system instance of the class implementing the 
EnvelopeResponseHandler interface. 

• CRRN2: The EnvelopeResponseHandler is a Temporary JCRE Entry Point Object (see Javacard 2.2.1 
Runtime Environment (JCRE) Specification [3]). 

5.2.13.1.1.1 Parameter errors 

No requirements. 



5.2.13.1.1.3 



Context errors 



• CRRC 1 : The method shall thrown ToolkitException.H ANDLER_NOT_AV AILABLE if the handler is not 
available. 

• CRRC2: After the first invocation of the ProactiveHandler.send method the EnvelopeResponseHandler is no 
more available. 
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5.2.13.1.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.13.1.3 



Test area files 

Test_Api_2_Ers_Gthd.j ava. 
Api_2_Ers_Gthd_ 1 .j ava. 
api_2_ers_g thd . c ap . 

Test coverage 



CRR number 


Test case number 


N1 


1,2,3 


N2 


checked in CAT Runtime Environment: Cre Api Hepo (Test case 3 and 4) 


C1 


checl<ed in CAT Runtime Environment: Cre IVIha Erhd (Test case 1) 


C2 


4 



5.2.13.1.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call getTheHandlerO twice 


The returned objects shall be the 
same 




2 


Verify that getTheHandler returns an 
EnvelopeResponseHandler 

Call getTheHandlerO method 


The reference returned shall be an 
object implementing the 
EnvelopeResponseHandler 
interface (check cast) 




3 


Verify the returned value is not null 

Call getTheHandlerO method 


The reference returned shall not be 
null. 




4 


Send a proactive command, and then, Call 
getTheHandlerO 


ToolkitException. HANDLER NOT 
AVAILABLE is thrown 





5.2.14 Class ProactiveHandlerSystem 
5.2.14.1 Method getTheHandler 

Test Area Reference: Api_2_Phs_Gthd. 

5.2.14.1.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public static ProactiveHandler getTheHandlerO 

throws ToolkitException 



5.2.14.1.1.1 



Normal execution 



• CRRNl: The method shall return the single system instance of the class implementing the ProactiveHandler 
interface. 

• CRRN2: The ProactiveHandler is a Temporary JCRE Entry Point Object (see Javacard 2.2.1 Runtime 
Environment (JCRE) Specification [3]). 

5.2.14.1.1.2 Parameter errors 
No requirements. 

5.2.14.1.1.3 Context errors 

• CRRC 1 : The method shall throw ToolkitException.H ANDLER_NOT_AV AILABLE if the handler is busy. 
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5.2.14.1.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.14.1.3 



Test area files 

Test_Api_2_Phs_Gthd.j ava. 

Api_2_Phs_Gthd_l.java. 

api_2_phs_gthd.cap. 

Test coverage 



CRR number 


Test case number 


N1 


1,2,3 


N2 


checked in CAT Runtime Environment: Cre Api Hepo (Test case 5 and 6) 


C1 


checl<ed in CAT Runtime Environment: Cre_IVIIia_Pahd (Test case 1) 



5.2.14.1.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call getTheHandlerO method twice 


The returned objects shall be the 
same 




2 


Call getTheHandlerO method 


The reference shall be an objetc 
implementing the 
ProactiveHandler interface 




3 


Call getTheHandlerO method 


The reference shall not be null 





5.2.15 Class ProactiveResponseHandlerSystem 
5.2.15.1 Method getTheHandler 

Test Area Reference: Api_2_Prs_Gthd. 

5.2.1 5.1 .1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public static ProactiveResponseHandler getTheHandler ( ) 

throws ToolkitException 



5.2.15.1.1.1 



Normal execution 



• CRRNl: The method shall return the single system instance of the object implementing the ProactiveHandler 
interface. 

• CRRN2: The ProactiveResponseHandler is a Temporary JCRE Entry Point Object (see Javacard 2.2.1 
Runtime Environment (JCRE) Specification [3]). 

5.2.15.1.1.2 Parameter errors 
No requirements. 

5.2.15.1.1.3 Context errors 

• CRRC 1 : The method shall throw ToolkitException.HANDLER_NOT_AV AILABLE if the handler is busy. 
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5.2.13.1.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.15.1.3 



Test area files 

Test_Api_2_Prs_Gthd.j ava. 
Api_2_Prs_Gthd_l .Java. 
api_2_prs_gthd.cap. 

Test coverage 



CRR number 


Test case number 


N1 


1,2,3 


N2 


checked in CAT Runtime Environment: Cre Api Hepo (Test case 7 and 8) 


C1 


checl<ed in CAT Runtime Environment: Cre_l\/lha_Prhd (Test case 1) 



5.2.15.1.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Build and send a Proactive Command 




Proactive Command 




Terminal Response 








Call getTheHandlerO twice method 


Tlie returned objects shall be the 
same 




2 


Call getTheHandlerO method 


The reference shall be an object 
implementing the 
ProactiveResponseHandler 
interface 




3 


Call getTheHandlerO method 


The reference shall not be null 





5.2.1 6 Class TerminalProfile 
5.2.16.1 Method check(byte index) 

Test Area Reference: Api_2_Tep_Checb. 

5.2.1 6.1 .1 Conformance requirement 

The method with following header shall compliant to its definition in the API. 

public static boolean check (byte index) 

throws ToolkitException 

5.2.1 6.1.1.1 Normal execution 

• CRRNl: The method checks a facility in the handset profile: returns true if supported and false otherwise. 

• CRRN2: returns false if facility-index is outside Terminal Profile data. 

5.2.16.1.1.2 Parameter errors 

• CRRPl : shall throw BAD_INPUT_PARAMETER ToolkitException if index has a negative value. 

5.2.16.1.1.3 Context errors 

• CRRC 1 : shall throw TERMIN AL_PROFILE_NOT_AV AILABLE ToolkitException if Terminal Profile data 
are not available. 
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5.2.16.1.2 Test area files 

Specific triggering: EVENT_STATUS_COMMAND: 
Test Source: Test_Api_2_Tep_Checb.java. 
Test Applet: Api_2_Tep_Checb_l.java. 

Cap File: api_2_tep_checb.cap. 



5.2.16.1.3 



Test coverage 



CRR number 


Test case number 


N1 


2,3 


N2 


4 


P1 


5 


C1 


1 



5.2.16.1.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


No Terminal Profile is registered 

1- Trigger applet with status command 

2- Call check method with Index = 1 


1- applet is triggered 
2- 

TERMINAL_PROFILE_NOT_AVAI 
LABLE ToolkitException is thrown 




2 


Terminal Profile, Facility is supported 

1- Trigger applet with 
EVENT_UNRECOGNIZED_ENVELOPE 

2- Call check method with 
index = 


1- applet is triggered 

2- returns true 




3 


Facility is not supported 

Call check ( ) method with index = 15 


returns false 




4 


Facility index Is outside TerminalProfile data 

Call check method with index = 0x7F 


Returns false 




5 


Index has a negative value 

Call check method with index = -1 


Throws a ToolkitException with 
BAD_INPUT_PARAMETER reason 
code. 





5.2.16.2 Method check(byte [] mask, short offset, short length) 

Test Area Reference: Api_2_Tep_Chec_Bss. 

5.2.16.2.1 Conformance requirement 

The method with following header shall compliant to its definition in the API. 

public static boolean check (byte [] mask, 

short offset, 
short length) 
throws Java . lang . NullPointerException, 

Java . lang . ArraylndexOutOf BoundsException, 
ToolkitException 
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5.2.16.2.1.1 



Normal execution 



• CRRNl: The method checks all the facilities corresponding to bits set to 1 in the mask buffer: returns true if 
the bitwise AND of the TerminalProfile data padded with and the mask is equal to the mask , false 
otherwise. 

• CRRN2: The method returns true if the length is equal to 0. 

5.2.16.2.1.2 Parameter errors 

• CRRPl: The method shall throw java.lang.NullPointerException if mask is null. 

• CRRP2: The method shall throw java.lang.ArraylndexOutOfBoundsException if check would cause access of 
data outside mask array bounds. 

• CRRP3: If offset or length parameter is negative an ArraylndexOutOfBoundsException exception is thrown 
and no check is performed. 

• CRRP4: If offset+length is greater than mask.length, the length of the mask array an 
ArraylndexOutOfBoundsException exception is thrown and no check is performed. 



5.2.16.2.1.3 



Context errors 



• CRRC 1 : The method shall throw TERMIN AL_PROFILE_NOT_AV AILABLE ToolkitException if Terminal 
Profile data are not available. 

5.2.16.2.2 Test area files 

Specific triggering: MENU_SELECTION: 

Test Source: Test_Api_2_Tep_Chec_Bss.java. 
Test Applet: Api_2_Tep_Chec_Bss_l.java. 

Cap File: api_2_tep_chec_bss.cap. 



5.2.16.2.3 



Test coverage 



CRR number 


Test case number 


N1 


9, 10, 11 


N2 


8 


PI 


2 


P2 


3, 4, 5, 6 


P3 


4,7 


P4 


6 


CI 


1 
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5.2.16.2.4 



Test procedure 



Id 


Description 


API Expectation 


APDU 
Expectation 


1 


No Terminal Profile is registered 

Triggered by Menu Selection 

Call check method: 

mask = 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF7F 

offset = 

length = 16 


TERMINAL PROFILE NOT 
_AVAILABLE 
ToolkitException is thrown 




2 


NULL as parameter to check 

Call check method: 
mask= NULL 


NullPointerException is 
thrown 




3 


Offset > mask.length 

Call check method: 

mask = OxFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF7F 

offset = 17 


ArraylndexOutOfBoundsExc 
option is thrown 




4 


Offset < 

Call check method: 

mask = 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF7F 

offset = -1 


ArraylndexOutOfBoundsExc 
option is thrown 




5 


Length > mask.length 

Call check method: 

mask = 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF7F 

offset = 

length = 18 


ArraylndexOutOfBoundsExc 
option is thrown 




6 


Offset + length > mask.length 

Call check method: 

mask = 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF7F 

offset = 9 

length = 9 


ArraylndexOutOfBoundsExc 
option is thrown 




7 


Length < 

Call check method: 

mask = 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF7F 

offset = 

length = -1 


ArraylndexOutOfBoundsExc 
eption is thrown 




8 


length = 

call check method: 

mask = 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF7F 

offset = 

length = 


Returns true 




9 


Check all the Terminal Profile 

Call check method: 

mask = 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF7F 

offset = 

length =16 


Returns false because 
facility 15 is not supported 




10 


Check a part of the Terminal Profile 

Call check method: 

mask = 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF7F 

offset = 15 

length = 2 


Returns true: the 16 first 
facilities except facility 15 
have been successfully 
checked 




11 


Check a part of the Terminal Profile 

Call check method: 
mask = 0x0080 
offset = 
length = 2 


Returns false: only facility 1 5 
is checked and not 
supported. 
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5.2.1 6.3 Method check(short index) 

Test Area Reference: Api_2_Tep_Checs. 

5.2.16.3.1 Conformance requirement 

The method with following header shall compliant to its definition in the API. 

public static boolean check (short index) 

throws ToolkitException 



5.2.16.3.1.1 



Normal execution 



• CRRNl: The method checks a facility in the handset profile: returns true if the facility is supported, false if 
facility is not supported, or if facility -index outside TerminalProfile data. 

• CRRN2: returns false if facility-index is outside Terminal Profile data. 

5.2.16.3.1.2 Parameter errors 

• CRRP 1 : shall throw B AD_INPUT_PARAMETER ToolkitException if index has a negative value. 

5.2.16.3.1.3 Context errors 

• CRRC 1 : shall throw TERMIN AL_PROFILE_NOT_AV AILABLE ToolkitException if Terminal Profile data 
are not available. 

5.2.16.3.2 Test area files 

Specific triggering: EVENT_STATUS_COMMAND. 
Test Source: Test_Api_2_Tep_Checs.java. 
Test Applet: Api_2_Tep_Checs_l.java. 

Cap File: api_2_tep_checs.cap. 



5.2.16.3.3 



Test coverage 



CRR number 


Test case number 


N1 


2,3,4 


N2 




P1 




C1 


1 



5.2.16.3.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


No Terminal Profile is registered 

1- Triggerapplet with status command 

2- Call check method with index = 1 


1 - applet is triggered 
2- 

TERMINAL_PROFILE_NOT_AVAI 
LABLE ToolkitException is thrown 




2 


Terminal Profile, Facility is supported 

1- Trigger applet with unrecognized 
envelope 

2- Call check ( ) method with index = 


Returns true 




3 


Facility is not supported 

Call check {) method with index = 15 


Returns false 
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4 


Facility index is outside TerminalProfile data 

Call check {) method with index = 0x0099 


Returns false 




5 


Index has a negative value 

Call check method with index = -1 


Throws a ToolkitException with 
BAD_INPUT_PARAMETER reason 
code. 





5.2.1 6.4 Method getValue(short indexMSB, short indexLSB) 

Test Area Reference: Api_2_Tep_Gval. 

5.2.16.4.1 Conformance requirement 

The method with following header shall compliant to its definition in the API. 

public static short getValue (short indexMSB, 

short indexLSB) 
throws ToolkitException 



5.2.16.4.1.1 



Normal execution 



• CRRNl: The method returns the binary value of a parameter, delimited by two indexes, from the handset 
profile. 



5.2.16.4.1.2 



Parameter errors 



CRRPl: The method shall throw BAD_INPUT_PARAMETER ToolkitException if (indexMSB >= indexLSB 
+16) or (indexMSB < indexLSB) or (indexMSB < 0) or (indexLSB < 0). 



5.2.16.4.1.3 



Context errors 



• CRRC 1 : The method shall throw TERMINAL_PROFILE_NOT_AV AILABLE ToolkitException if Terminal 
Profile data are not available. 

5.2.16.4.2 Test area files 

Specific triggering: EVENT_STATUS_COMMAND. 
Test Source: Test_Api_2_Tep_Gval.java. 
Test Applet: Api_2_Tep_Gval_l.java. 

Cap File: api_2_tep_gval.cap. 



5.2.16.4.3 



Test coverage 



CRR number 


Test case number 


N1 


2,3 


P1 


4, 5, 6, 7 


C1 


1 
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5.2.16.4.4 Test procedure 

TP = FF 01 D2 FO 00 00 00 00 00 00 00 00 00 8D FF 



Id 


Description 


API Expectation 


APDU Expectation 


1 


No Terminal Profile is registered 

Triggered by status command 
Call getValueO method: 
indexMSB = 15, indexLSB = 


TERMINAL_PROFILE_NOT_AVAI 
LABLE ToolkitException is thrown 




2 


Retrieve number of character down Terminal 
display in Terminal Profile which is 13 

Call getValueO method: 
indexMSB = 108, indexLSB = 104 


Returns 13 




3 


Retrieve byte 3 and byte 4 from terminal 
profile. 

Byte 3 = 0xD2, Byte 4 = OxFO 
Call getValueO method: 
indexMSB = 31, indexLSB =16 


Returns 0xF0D2 




4 


indexMSB is negative 

call getValueO method: 

indexMSB = OxFFFF, indexLSB = OxFFFD 


BAD_INPUT_PARAMETER 
ToolkitException is thrown 




5 


indexLSB is negative 

Call getValue method: 

indexMSB = 0x0002, indexLSB = OxFFFD 


BAD_INPUT_PARAMETER 
ToolkitException is thrown 




6 


indexMSB < indexLSB 

Call getValueO method: 

indexMSB = 0x0002, indexLSB = 0x0003 


BAD_INPUT_PARAMETER 
ToolkitException is thrown 




7 


indexMSB > indexLSB + 16 

Call getValueO method: 

indexMSB = 0x0021, indexLSB = 0x0010 


BAD_INPUT_PARAMETER 
ToolkitException is thrown 




8 


indexMSB = indexLSB + 16 

Call getValueO method: 

indexMSB = 0x0020, indexLSB = 0x0010 


BAD_INPUT_PARAMETER 
ToolkitException is thrown 




9 


indexMSB is outside data available 

Call getValueO method: 
indexMSB = 121, indexLSB = 115 


Returns 0x001 F 





5.2.1 6.5 Method copy(short startOffset, byte[] dstBuffer, short dstOffset, short 
dstLength) 

Test Area Reference: Api_2_Tep_Copy. 

5.2.16.5.1 Conformance requirement 

The method with following header shall compliant to its definition in the API. 

public static short copy (short startOffset, 

byte[l dstBuffer, 
short dstOffset, 
short dstLength) 
throws ToolkitException 

5.2.16.5.1.1 Normal execution 

• CRRN 1 : The method copies a part of the handset profile in a buffer. 

• CRRN2: The method returns dstOffset + dstLength. 
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5.2.16.5.1.2 Parameter errors 

• CRRP 1 : if dstBuffer is null NullPointerException is thrown. 

• CRRP2 : //"dstOffset or dstljength parameter is negative an 
ArraylndexOutOfBoundsException exception is thrown and no copy is performed 

• CRRP3: /fdstOf f set+dstLength is greater than dstBuffer . length, the length of the dstBuffer 
array an ArraylndexOutOfBoundsException exception is thrown andno copy is performed 



5.2.16.5.1.3 



Context errors 



• CRRC 1 : The method shall throw TERMINAL_PROFILE_NOT_AV AILABLE ToolkitException if Terminal 
Profile data are not available. 

5.2.16.5.2 Test area files 

Specific triggering: EVENT_STATUS_COMMAND. 
Test Source: Test_Api_2_Tep_Copy.java. 
Test Applet: Api_2_Tep_Copy_l.java. 

Cap File: api_2_tep_copy.cap. 



5.2.16.5.3 



Test coverage 



CRR number 


Test case number 


N1 


8,9, 10, 11 


N3 


8,9, 10, 11 


PI 


2 


P2 


4,5 


P3 


3,6,7 


01 


1 



5.2.16.5.4 Test procedure 

TP = FF 01 D2 FO 01 02 00 00 00 00 00 00 00 8D FF 



Id 


Description 


API Expectation 


APDU Expectation 


1 


No Terminal Profile is registered 

Triggered by status command 
Call copyO method: 
StartOffset = 
dstBuffer.length = 6 
dstOffset = 
dstLength = 6 


TERMINAL_PROFILE_NOT_AVAI 
LABLE ToolkitException is thrown 




2 


dstBuffer is null 


NullPointerException is thrown 




3 


dstOffset > dstBuffer.length 

Call copyO method: 
StartOffset = 
dstBuffer.length = 5 
dstOffset = 5 
dstLength = 1 


ArraylndexOutOfBoundsException 
is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


4 


dstOffset < 

Call copyO method: 
StartOffset = 
dstBuffer .length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsException 
is thrown 




5 


dstLength < 

Call copyO method: 
StartOffset = 
dstBuffer .length = 5 
dstOffset = 1 
dstLength = -1 


ArraylndexOutOfBoundsException 
is thrown 




6 


dstLength >dstBuffer.length 

Call copyO method: 
StartOffset = 
dstBuffer .length = 5 
dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsException 
Is thrown 




7 


dstOffset + dstLength >dstBuffer.length 

Call copyO method: 
StartOffset = 
dstBuffer. length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsException 
is thrown 




8 


Successful call extreme values 

Call copyO method: 
StartOffset = 
dstBuffer . length = 6 
dstOffset = 
dstLength = 6 


Result of copyO is 6 




9 


Successful call any values 

Call copyO method: 
StartOffset = 1 
dstBuffer .length = 20 
dstOffset = 3 
dstLength = 4 


Result of copyO is 7 




10 


Successful call, copy with length =0 

Call copyO method: 
StartOffset = 
dstBuffer .length = 20 
dstOffset = 20 
dstLength = 


Result of copyO is 20 




11 


Value outside ProfileDownload data available 

Call copyO method: 
StartOffset = 13 
dstBuffer . length = 6 
dstOffset = 
dstLength = 6 


Result of copyO is 6 





5.2.17 Class ToolkitRegistrySystem 

5.2.17.1 Method getEntry 

Test Area Reference: Api_2_Trs_Gety. 

5.2.1 7.1 .1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public static ToolkitRegistry getEntry () 

throws ToolkitException 
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5.2.1 7.1 .1 .1 Normal execution 

• CRRNl: returns a reference to the applet ToolkitRegistry object of the calling applet. 

• CRRN2: Each successive call to getEntryO method shall return the same object. 

5.2.17.1.1.2 Parameter errors 
No requirements. 

5.2.17.1.1.3 Context errors 

• CRRCl: This method returns null if the Applet.register() has not yet been invoked. 

• CRRC2: This method returns null if the server does not exist. 

• CRRC3: This method returns null if the server returns null. 

• CRRC4: ToolkitException with REGIS TRY_ERROR reason code shall be thrown in any case of register 
error. 



5.2.17.1.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.17.1.3 



Test area files 

Test_Api_2_Trs_Gety .j ava. 
Api_2_Trs_Gety_l .Java. 
api_2_trs_gety.cap. 

Test coverage 



CRR number 


Test case number 


N1 


2 


N2 


3 


C1 


1 


C2 


Not testable 


C3 


Not testable 


C4 


Not testable 



5.2.17.1.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call before register() method 

In the constructor, the applet instance 
calls the getEntryO method. 


Returns null 




2 


Call after registerQ method 

In the install method and after the call 
to register method, call the getEntryO 
method. 


A not null reference is returned. 
No exception shall be thrown 




3 


Check it returns the same entry 

The applet calls the getEntryO method 
again, in the processToolkit () method. 


Returns the same ToolkitRegistry 
object reference as for test case 2. 
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5.2.18 Class ToolkitException 



5.2.18.1 ToolkitException Constructor 

Test Area Reference: Api_2_Tke_Coor. 

5.2.1 8.1 .1 Conformance requirement: 

The constructor with following header shall be compliant to its definition in the API. 

public ToolkitException (short reason) 

5.2.18.1.1.1 Normal execution 

• CRRNl: Construct a ToolkitException instance with the specified reason. 



5.2.18.1.1.2 
No requirements. 

5.2.18.1.1.3 
No requirements. 

5.2.18.1.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.18.1.3 



Parameter errors 
Context errors 
Test area files 

Test_Api_2_Tke_Coor.j ava. 
Api_2_Tke_Coor_l .j ava. 
api_2_tke_coor.cap. 

Test coverage 



CRR number 


Test case number 


N1 


1 



5.2.18.1.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


reason = (short) 19 


ToolkitException. getReasonQ = 
(short)19 





5.2.18.2 Method throwit 

Test Area Reference: Api_2_Tke_Thit. 

5.2.18.2.1 Conformance requirement 

The method with following header shall compliant to its definition in the API. 

public static void throwit (short reason) 

throws ToolkitException 

5.2.18.2.1.1 Normal execution 

• CRRNl: Throws the JCRE instance of the ToolkitException class with the specified reason. 

• CRRN2: extends javacard.framework.CardRuntimeException. 
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5.2.18.2.1.2 
No requirements. 

5.2.18.2.1.3 
No requirements. 

5.2.18.2.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.18.2.3 



Parameter errors 
Context errors 
Test area files 

Test_Api_2_Tke_Thit.j ava. 
Api_2_Tke_Thit_ 1 .j ava. 
api_2_tke_thit. cap . 

Test coverage 



CRR number 


Test case number 


N1 


1,2,3 


N2 


4,5,6 



5.2.18.2.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Throws the JCRE instance of ToolkitException 
with the specified reason 


Reason = 




2 


Throws the JCRE instance of ToolkitException 
with the specified reason 


Reason = 1 




3 


Throws the JCRE instance of ToolkitException 
with the specified reason 


Reason = 0xA55A 




4 


ToolkitException extends 
javacard.framework.CardRuntimeException 


Reason = 




5 


ToolkitException extends 
javacard.framework.CardRuntimeException 


Reason = 1 




6 


ToolkitException extends 
javacard.framework.CardRuntimeException 


Reason = 0xA55A 





5.2.18.3 Reason Codes 

Test Area Reference: Api_l_Tke_Cons. 

5.2.18.3.1 Conformance Requirement 

There is no API, only constants. These constants shall compliant to its definition in the APT 

5.2.18.3.1.1 Normal execution 

• CRRN 1 : The Constants of the class ToolkitException shall all have the same name and value defined in the 

TS 102 241 [13]. 

• CRRN2: Constructs ToolkitException an Exception with the specified reason. 

5.2.18.3.1.2 Parameter errors 
No requirements. 

5.2.1 8.3.1 .3 Context errors 
No requirements. 
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5.2.18.3.2 Test area files 

None. 

5.2.18.3.3 Test Coverage 



CRR number 



N1 &N2 



Test case number 



The constants in Java are resolved at compilation time, therefore a runtime test is not 
useful. No test of constants will be performed 



5.2.18.3.4 Test Procedure 

None. 
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5.3 Package uicc.access.fileadministration 

5.3.1 Interface AdminFileView 

5.3.1 .1 Method createFile(ViewHandler viewHandler) 

Test Area Reference: Api_4_Afv_Crtf. 

5.3.1 .1 .1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void createFile (ViewHandler viewHandler) 

throws Java . lang . NullPointerException, 
UICCException, 
AdminException, 
javacard. framework .TransactionException 

5.3.1.1.1.1 Normal execution 

• CRRNl: This method creates a new file under the current DF or ADF, as described in TS 102 222 [8]. 

5.3.1.1.1.2 Parameter errors 

• CRRPl: If viewHandler is null, an instance of Java. lang. NullPointerException shall be thrown. 

• CRRP2: If the viewHandler parameter includes incorrect parameters, an instance of AdminException shall be 
thrown. The reason code shall be AdminException.INCORRECT_PARAMETERS. 

5.3.1.1.1.3 Context errors 

• CRRCl: If the method call causes a memory problem (e.g. memory access error), an instance of 
UICCException shall be thrown. The reason code shall be UICCException.MEMORY_PROBLEM. 

• CRRC2: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
UICCException shall be thrown. The reason code shall be UICCException.INTERNAL_ERROR. 

• CRRC3: If the file identifier of the EF being created already exists, an instance of AdminException shall be 
thrown. The reason code shall be AdminException.FILE_ALREADY_EXISTS. 

• CRRC4: If the DF name already exists, an instance of AdminException shall be thrown. The reason code shall 
be AdminException.DF_NAME_ALREAD Y_EXISTS . 

• CRRC5: If there is not enough memory, an instance of AdminException shall be thrown. The reason code 
shall be AdminException.NOT_ENOUGH_MEMORY_SPACE. 

• CRRC6: If the access conditions are not satisfied, an instance of UICCException shall be thrown. The reason 
code shall be UICCException.SECURITY_STATUS_NOT_SATISFIED. 

5.3.1.1.2 Test area files 

Test Source: Test_Api_4_Afv_ Crtf.java. 
Test Applet: Api_4_Afv_ Crtf _1 .Java. 

Cap File: api_4_Afv_ Crtf.cap. 
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5.3.1.1.3 



Test coverage 



CRR number 


Test case number 


N1 


1,2 


P1 


3 


P2 


4 


C1 


Not testable 


C2 


Not testable 


C3 


5 


C4 


6 


C5 


Not testable 


C6 


7 



5.3.1.1.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Create an EF 

1- applet is triggered by sending an 
unrecognized envelope 

2- get an AdminFileView 

AdminFileViewBuilder . getTheUICCAdminFil 
eView (CLEAR_ON_RESET) 

3- select MF/DFiest 

4- create transparent EFrfoo (6F29) 

5- select EFrfuo^ update binary 12 34 56 

6- create Linear fixed EFrfui 

7- select EFrfui^ update record 01 

8- create Cyclic EFrfo2 

9- select EFrfo2, update record 01 
record: 1 

value: 12 34 56 

Applet finalizes 

10- select MF/DFtest/EFrfoo, read binary 

11- select MF/DFiest/EFrfui, read record 1 

12- select MF/DFtest/EFrfu2 ,read record 1 


4- no exception shall be thrown 


10- returns: 12 34 56 

11- returns: 02 

12- returns: 12 34 56 


2 


Create a DF in ADF1 

1- applet is triggered by sending an 
unrecognized envelope 

2- get an AdminFileView 

AdminFileViewBuilder . getTheAdminFileVie 
w (AID_ADF1, CLEAR_ON_RESET) 

3- select ADFI/DFiest 

4- create DFrfoi (5F01) 

5- select DFrfoi 

6- create EFrfoi {6F2A) 

7- select EFrfoi^ update binary 12 34 56 
Applet finalizes 

8- select ADFI/DFiest/EFrfoi (6F2A), read 
binary 

9- Reset 




8- returns: 12 34 56 


3 


Call createFile with a null viewHandler 

1- call createFile with null. 


1- java.lang.NullPointerException shall be 
thrown 




4 


Call createFile with incorrect parameters 

1- call createFile with incorrect 
parameters . 


1- 

AdminException.lNCORRECT_PARAME 
TERS shall be thrown 




5 


EF already exists 

1- Select MF/DFiEST 

2- Call createFile (EFisRo) 


2- 

AdminExceptlon.FILE ALREADY EXIST 
S 
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Id 


Description 


API Expectation 


APDU Expectation 


6 


DF already exists 

1- Call createFile (DFtest) 


1- 

AdminException.DF NAME ALREADY 

EXISTS 




7 


Security status not satisfied 

1- Select MF/DFiEST/DFaRE2 

2- Call createFile to create some 
transparent file. 


2- 

UlCCException.SECURITY STATUS N 

OT SATISFIED 





5.3.1 .2 Method deleteFile(short fid) 

Test Area Reference: Api_4_Afv_Dltf. 

5.3.1.2.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void deleteFile (short fid) 

throws UICCException, 

javacard. framework . TransactionException 



5.3.1.2.1.1 



Normal execution 



CRRNl: This method initiates the deletion of an EF immediately under the current DF, or a DF with its 
complete subtree, as described in TS 102 222 [8]. 



5.3.1.2.1.2 
Not applicable 

5.3.1.2.1.3 



Parameter errors 



Context errors 



CRRCl: If the method call causes a memory problem (e.g. memory access error), an instance of 
UICCException shall be thrown. The reason code shall be UICCException.MEMORY_PROBLEM. 

CRRC2: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
UICCException shall be thrown. The reason code shall be UICCException.INTERNAL_ERROR. 

CRRC3: If the file cannot be found in the current directory, an instance of UICCException. shall be thrown. 
The reason code shall be UICCException. FILE_NOT_FOUND. 

CRRC4: If the access conditions are not satisfied, an instance of UICCException shall be thrown. The reason 
code shall be UICCException.SECURITY_STATUS_NOT_SATISFIED. 

CRRC5: If the operation would cause the commit capacity to be exceeded, an instance of 
javacard. framework.TransactionException shall be thrown. 



5.3.1.2.2 

Test Source: 
Test Applet: 
Cap File: 



Test area files 

Test_Api_4_Afv_ Dltf.java 
Api_4_Afv_ Dltf _l.java. 
api_4_Afv_ Dltf.cap. 
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5.3.1.2.3 



Test coverage 



CRR number 


Test case number 


N1 


1,2,3,4 


CI 


Not testable 


C2 


Not testable 


C3 


5 


C4 


6 


C5 


Not testable 



5.3.1.2.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Initialization 

1- applet is triggered by sending an 
unrecognized envelope 

2- get an AdminFileView 

AdminFileViewBuilder . getTheUICCAdminFileVi 
ew (CLEAR_ON_RESET) 

3- select MF/DFiest 

4- create DFrfui 

5- select DFrfoi 

6- create DFrfo2 , create EFrfoi, create EFrfo2 

7- select DFrfo2 

8- create EFrfoi 

9- get an AdminFileView 

AdminFileViewBuilder . getTheAdminFileView (A 
ID_ADF1, CLEAR_ON_RESET) 

10- select MF/DFiEST 

11- create DFrfoi 

12- select DFrfoi 

13- create DFrfo2 , create EFrfoi, create 

EFrf02 

14- select DFrfo2 

15- create EFrfoi 






1 


Delete EF 

1- Select MF/DFtest/DFrfoi 

2- call deleteFile (EFrfoi) 

3- Select MF/DFiest/DFrfoi/EFrfoi 


2- no exception shall be thrown 

3- UlCCException.FILE NOT FOUND is thrown 




2 


Delete EF in ADF1 

1- Select ADFI/DFiest/DFrfoi 

2- call deleteFile (EFrfoi) 

3- Select ADFI/DFiest/DFrfoi/EFrfoi 


2- no exception shall be thrown 

3- UICCException.FILE_NOT_FOUND is thrown 




3 


Delete DF and its subtree 

1- Select MF/DFiEST 

2- call deleteFile (DFrfoi) 

3- Select MF/DFtest/DFrfoi 


2- no exception shall be thrown 

3- UICCException.FILE_NOT_FOUND is thrown 




4 


Delete DF and its subtree in ADF1 

1- Select ADFl/DFiEST 

2- call deleteFile (DFrfoi) 

3- Select ADFI/DFiest/DFrfoi 


2- no exception shall be thrown 

3- UICCException.FILE_NOT_FOUND is thrown 




5 


File not found 

1- Select MF/DFiEST 

2- call deleteFile (DFrfoi) 

3- Select ADFI/DFiest 

4- call deleteFile (EFrfoi) 


2- UICCException.FILE_NOT_FOUND 
4- UICCException.FILE_NOT_FOUND 




6 


Security status not satisfied 

1- Select MF/DFTEST/DFARR2 

2- call deleteFile (EFTaR2T) 


2- 

UlCCException. SECURITY STATUS NOT SA 

TISFIED 
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5.3.1.3 Method resizeFile(ViewHandler viewHandler) 

Test Area Reference: Api_4_Afv_Rszf. 

5.3.1.3.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void resizeFile (ViewHandler viewHandler) 

throws Java . lang . NullPointerException, 
UICCException, 
AdminException, 
javacard. framework .TransactionException 

5.3.1.3.1.1 Normal execution 

• CRRNl: This method resizes a file under the current DF or ADF, as described in TS 102 222 [8]. 

5.3.1.3.1.2 Parameter errors 

• CRRPl: If viewHandler is null, an instance of Java. lang. NullPointerException shall be thrown. 

• CRRP2: If the viewHandler parameter includes incorrect parameters, an instance of AdminException shall be 
thrown. The reason code shall be AdminException.INCORRECT_PARAMETERS. 

5.3.1.3.1.3 Context errors 

• CRRCl: If the method call causes a memory problem (e.g. memory access error), an instance of 
UICCException shall be thrown. The reason code shall be UICCException.MEMORY_PROBLEM. 

• CRRC2: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
UICCException shall be thrown. The reason code shall be UICCException.INTERNAL_ERROR. 

• CRRC3: If the file cannot be found in the current directory, an instance of UICCException. shall be thrown. 
The reason code shall be UICCException. FILE_NOT_FOUND. 

• CRRC4: If the access conditions are not satisfied, an instance of UICCException shall be thrown. The reason 
code shall be UICCException.SECURITY_STATUS_NOT_SATISFIED. 

• CRRC5: If the operation would cause the commit capacity to be exceeded, an instance of 
javacard. framework.TransactionException shall be thrown. 

• CRRC6: If there is not enough memory, an instance of AdminException shall be thrown. The reason code 
shall be AdminException.NOT_ENOUGH_MEMORY_SPACE. 

• CRRC7: If the conditions of use are not satisfied, an instance of AdminException shall be thrown. The reason 
code shall be AdminException.CONDITIONS_OF_USE_NOT_SATISFIED. 

• CRRC8: If the method resizeFile() is applied to a non compatible file, an instance of UICCException shall be 
thrown. The reason code shall be UICCException.COMMANDJNCOMPATIBLE. 

• CRRC9: If the method resizeFile() is applied to invalidated data, an instance of UICCException shall be 
thrown. The reason code shall be UICCException.REF_DATA_INVALIDATED. 

5.3.1.3.2 Test area files 

Test Source: Test_Api_4_Afv_ Rszf.java. 
Test Applet: Api_4_Afv_ Rszf _1 .Java. 

Cap File: api_4_Afv_ Rszf cap. 
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5.3.1.3.3 



Test coverage 



CRR number 


Test case number 


N1 


1,2 


P1 


3 


P2 


4 


C1 


Not testable 


C2 


Not testable 


C3 


5 


C4 


6 


C5 


Not testable 


C6 


Not testable 


C7 


Not testable 


C8 


7 


C9 


8 



5.3.1.3.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Resize a Transparent EF 

1- Trigger the applet with an unrecognized 
envelope 

2- Select MF/DFiest 

3- Call ResizeFileO on EFtaro 

new size: 10 bytes 

Applet finalizes 

4- Select MF/DFiEST/EFisHn and check size in 
the returned FCP template. 

5- Restore EFiaho 




4- should return a size 
of 1 bytes 


2 


Resize a Linear Fixed EF 

1- Trigger the applet with an unrecognized 
envelope 

2- Select MF/DFiest 

3- Call ResizeFileO on EFLARU 

add 2 records . 

Applet finalizes 

4- Select MF/DFtest/EFlaro and check size in 
the returned FCP template. 

5- Restore EFlaru 




4- should return a size 
of 1 6 bytes 


3 


Call resizeFlle with a null viewHandler 

1- Call resizeFlle with null. 


1- java.lang.NullPointerException shall be 
thrown 




4 


Call createFile with incorrect parameters 

1- Call createFile with incorrect 
parameters . 


1- 

AdminExceptiogn.lNCORRECT_PARAMETERS 
shall be thrown 




5 


File not found 

1- Select MF/DFiEST 

2- Call resizeFlle (DFrfoi) 

3- Select ADFI/DFiest 

4- Call resizeFlle (EFrfoi) 


2- UICCException.FILE_NOT_FOUND shall be 
thrown 

4- UICCException.FILE_NOT_FOUND shall be 
thrown 




6 


Security status not satisfied 

1- Select MF/DFTEST/DFARR2 

2- Call resizeFlle (EFiAR2i) 


2- 

UICCException.SECURITY_STATUS_NOT_SA 
TISFIED shall be thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


7 


Command incompatible 

1- Select MF/DFiEST, call resizeFile (EFcaro) 


l-UICCException.COMMANDJNCOMPATIBLE 
shall be thrown 




8 


Invalidated data 

1- Select MF/DFiEST 

2- Invalidate EFiaHo 

3- Call resizeFile (EFiARo) 

4- Validate EFiaru 


3-UICCException.REF_DATA_INVALIDATED 
shall be thrown. 





5.3.1 .4 Method select (byte sfi) 

Test Area Reference: Api_4_Afv_Slctb. 
5.3.1.4.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void select (byte sfi) 

throws UICCException 

5.3.1.4.1.1 Normal execution 

• CRRNl: Selects a file by its Short File Identifier in the current directory of the File View. 

• CRRN2: Allows to update the current file without handling the Select Response. 

• CRRN3: The current EF it self can be selected. 

• CRRN4: The file context associated with the FileView object is changed after successful execution. 

5.3.1.4.1.2 Parameter errors 

• CRRPl : If the file which sfi matches is not in the current directory or no file matches the sfi, an instance of 
UICCException shall be thrown. The reason code shall be UICCException.FILE_NOT_FOUND. 



5.3.1.4.1.3 



Context errors 



CRRCl: If the method call causes a memory problem (e.g. memory access error), an instance of 
UICCException shall be thrown. The reason code shall be UICCException.MEMORY_PROBLEM 

CRRC2: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
UICCException shall be thrown. The reason code shall be UICCException.INTERNAL_ERROR. 



5.3.1.4.2 

Test Source: 
Test Applet: 
Cap File: 



Test area files 

Test_Api_4_Afv_ Slctb.java. 
Api_4_Afv_ Slctb _l.java. 
api_4_Afv_ slctb. cap. 
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5.3.1.4.3 



Test coverage 



CRR number 


Test case number 


N1 


1,2,4 


N2 


Not testable 


N3 


3 


N4 


5 


P1 


4 


C1 


Not testable 


C2 


Not testable 



5.3.1.4.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Selection possibilities, UICC file system 

1- get an AdminFileView 

AdminFileViewBuilder . getTheUICCAdminFil 
eView (CLEAR_ON_RESET) 

2- select DFiest, fid=llll 

3- select with sfi EFtnr, sfi=0x01 

4- select with sfi EF™d, sfi=0x02 

5- select with sfi EFcnu, sfi = 0x05 


2- no exception shall be thrown 

3- no exception shall be thrown 

4- no exception shall be thrown 

5- no exception shall be thrown 




2 


Selection possibilities, ADF1 

1- get an AdminFileView 

AdminFileViewBuilder . getTheAdminFileVie 
w (AID_ADF1, CLEAR_ON_RESET) 

2- select DFiest, fid=llll 

3- select with sfi EF™h, sfi = 0x01 

4- select with sfi EF™o, sfi = 0x02 

5- select with sfi EFcnu, sfi=0x05 


2- no exception shall be thrown 

3- no exception shall be thrown 

4- no exception shall be thrown 

5- no exception shall be thrown 




3 


Current EF itself can be selected 

1- get an AdminFileView 

AdminFileViewBuilder . getTheUICCAdminFil 
eView (CLEAR_0N_RESET) 

2- select DFiest, fid=llll 

3- select with sfi EFinr, sfi=0x01 

4- select with sfi EFinr, sfi=0x01 


4- no exception shall be thrown 




4 


FILE_NOT_FOUND 

1- try to select a file with sfi=0x55 


1- shall throw an 

uicc. access. UlCCException with 

reason code FILE NOT FOUND 




5 


File context changed 

1- select EFiaRu, sfi = 0x03 
read 3 first bytes 

2- select EF™d, sfi = 0x02 
read file content 


1- file content should be 
{OxFF,OxFF,OxFF} 

2- file content should be 
{0x55,0x55,0x55} 





5.3.1 .5 Method select(short fid, byte[] fcp, short fcpOffset, short fcpLength) 

Test Area Reference: Api_4_Afv_Slctb_bss. 



5.3.1.5.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

public short select (short fid, 
byte [ 1 fcp, 
short fcpOffset, 
short fcpLength) 
throws Java . lang . NullPointerException, 

Java. lang. ArraylndexOutOfBoundsException, 
UlCCException 
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5.3.1.5.1.1 Normal execution 

CRRNl: Selects a file of the UICC file system or of an ADF file system as defined in TS 102 221 [6]. 

CRRN2: The method returns the FCP information in a form of a TLV structure as specified in TS 102 221 [6]. 

CRRN3: If the fcpLength is greater than the length of the response, the whole response is copied into the fcp 
buffer and the length of the response is returned by the method. 

CRRN4: If the fcpLength is smaller than the length of the response, the first part of the response is copied into 
the fcp buffer and the fcpLength is returned by the method. 

CRRN5: After selecting a ADF/MF/DF no EF is selected. 

CRRN6: After selecting a linear fixed EF no record is selected. 

CRRN7: After selecting a cyclic EF the last updated record is the first record. 

CRRN8: Any file can be selected by FID which is an immediate child of the current directory. 

CRRN9: Any DF can be selected by FID which is an immediate child of the parent of the current DF. 

CRRNIO: The parent of the current directory can be selected by the FID. 

CRRNl 1: The ADF of the current active application can be selected by the FID. 

CRRN12: The ADF/MF can always be selected. 

CRRNl 3: The file context associated with the File View object is changed after successful execution. 

CRRN14: The current file context of any other applets shall not be changed. This will be tested during the 
testing of the framework. 

5.3.1.5.1.2 Parameter errors 

• CRRPl : If the array fcp is null, an instance of NullPointerException shall be thrown. 

• CRRP2: If fcpOffset is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

• CRRP3: If fcpLength is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

• CRRP4: If fcpOffset plus fcpLength is greater than the length of the array fcp. length an instance of 
ArraylndexOutOfBoundsException shall be thrown. 

5.3.1.5.1.3 Context errors 

• CRRCl: If the file with a File-ID which matches fid could not be found according to the selection rules, an 
instance of UICCException shall be thrown. The reason code shall be UICCException.FILE_NOT_FOUND. 

• CRRC2: If the method call causes a memory problem (e.g. memory access error), an instance of 
UICCException shall be thrown. The reason code shall be UICCException.MEMORY_PROBLEM. 

• CRRC3: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
SIMViewException shall be thrown. The reason code shall be UICCException.INTERNAL_ERROR. 

5.3.1.5.2 Test area files 

Test Source: Test_Api_4_Afv_Slctb_bss.java. 
Test Applet: Api_4_Afv_Slctb_bss_l.java. 

Cap File: api_4_Afv_slctb_bss.cap. 
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5.3.1.5.3 



Test coverage 



CRR number 


Test case number 


N1 


1, 2, 3,4,5, 6,7,8, 14, 18,20,21 


N2 


1,2,3,4,5,6,7,8, 14, 18,20,21 


N3 


1 


N4 


2,3,4,5,6,7,8 


N5 


15,19 


N6 


17 


N7 


18 


N8 


14 


N9 


14 


N10 


14 


N11 


19,20 


N12 


20 


N13 


20 


N14 


1,2,3,4,5,6,7,8, 14, 18,20 


P1 


9 


P2 


10 


P3 


11 


P4 


12, 13 


C1 


16 


C2 


Not testable 


C3 


Not testable 



5.3.1.5.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Get an AdminFileView object, UICC file 
system 

get an AdminFileView 

FileView . getTheUICCAdminFileView (CLEAR_0 

N_RESET) 






1 


Select EFTARU in MF (Transparent EF) 

Select DFiEST 

select EFiARo, 

fid=6F03 

byte [ ] fcp = new byte [132] 

fcpOffset = 

fcpLength = 127 


Shall return at least 19. 

fcp[] shall contain following TLVs: 

1.82 02 41 21 //file descriptor 

2. 83 02 2F E2 //file id 

3. 8A 01 05 //life cycle status 

4. 80 02 00 OA // file size 




2 


Select EFTARU in MF (Transparent EF) 

select EFtaru, 
fid=6F03 
fcpOffset = 
fcpLength = 7 
select {) 


Shall return 7. 

fcp[] shall contain the first 7 bytes of 

the FCP structure and contain 

following TLV. 

1.82 02 41 21 //file descriptor 




3 


Select DFTEST in MF 

fid = DFiEST, fid=llll 
fcpOffset = 
fcpLength = 127 
select 


Shall return at least 17. 

fcp[] shall contain following TLVs 

1.82 02 78 21 //file descriptor 

2. 83 02 1 1 11 //file id 

3. 8A 01 05 //life cycle status 




4 


Select EFCARU in DFTEST (Cyclic EF) 

select EFcARo, 
fid=6f09 
fcpOffset = 
fcpLength = 11 
select 


Shall return: 1 1 

fcp[] shall contain following TLV: 

82 05 46 21 00 03 02 




5 


Select ADF1 

select ADF 

fid=7FFF 

fcp[0:5]=0x00 

fcpOf f set=5 

fcpLength=127 

select 


Shall return: at least 27 
The first 5 bytes of fcp[] shall be 0x00 
and contains following TLVs: 
1.82 02 78 21 //file descriptor 

2. 84 10 AO 00 00 00 09 00 05 FF FF 
FF FF 89 60 00 00 00 //DF Name 

3. 8A01 05 //life cycle 
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6 


Select MF 

select MF, 
fid= 3F00 
fcpOffset = 
fcpLength = 11 
select {) 


Shall return: 11 

fcp[] shall contain following TLVs: 

1 . 82 02 38/78 21 //file descriptor 

2. 83 02 3F 00 //file ID 




7 


Select DFTELECOM in MF 

select DFiELEcoM, 

fid=7F10 

fcp[0] = fcp[l] = 0x05 

fcpOffset = 2 

fcpLength = 13 

select {) 


Shall return 13. 

The first 2 bytes of fcp[] shall be 0x05 

and fcp[] shall contain following TLVs 

1 . 82 02 38/78 21 //file descriptor 

2. 83 02 7F 1 //file id 




8 


Select EFLARU in DFTELECOM (Linear 
FixedEF) 

select EFlaro, 
fid = 6F0C 
fcpOffset = 
fcpLength =14 


Shall return 14. 

fcp[] shall contain following TLVs: 

1.82 05 42 21 00 04 02 

2. 83 02 6F OC 




9 


fcp is null 

select EFlsro, 

fid = 6F0C 

byte [ ] nullBuffer = null 

fcpOffset = 

fcpLength = 15 


Shall throw 
java.lang.NullPointerException 




10 


fcpOffset < 

select EFlaho, 
fid = 6F0C 
fcpOffset = -1 
fcpLength = 15 


Shall throw 

java.lang.ArraylndexOutOfBoundsExce 

ption 




11 


fcpLength < 

select EFlaho, 
fid = 6F0C 
fcpOffset = 
fcpLength = -1 


Shall throw 

java.lang.ArraylndexOutOfBoundsExce 

ption 




12 


fcpOffset + fcpLength > fcp.length 

select EFlaru, 
fid = 6F0C 
fcpOffset = 115 
fcpLength = 18 


Shall throw 

java.lang.ArraylndexOutOfBoundsExce 

ption 




13 


fcpOffset + fcpLength > fcp.length 

select EFlaro, 

fid = 6F0C 

fcpOffset = fcp.length+1 

fcpLength = 


Shall throw 

java.lang.ArraylndexOutOfBoundsExce 

ption 




14 


Selection possibilities 

0- select MF, fid=3F00 

1- select EFoicc, fid=2FF0 

2- select DFiest, fid=llll 

3- select EFcnu, fid=6F05 

4- select EFiaaa, fid=6F16 

5- select DFsobjest, fid=2211 

6- select DFiest, fid=llll 

7- select EFiaaa, fid=6F16 

8- select DFiest, fid=llll 

9- select MF, fid=3F00 

10- select DFiest, fid=llll 

11- select EFiaaa, fid=6F16 

12- select MF, fid=3F00 


No exception shall be thrown. 




15 


EF not selected after MF/DF selection 

1- select MF, 
fid = 3F00 
select EFicciD, 
fid = 2FE2 
2 - select MF 
fid = 3F00 
select 
readBinary () 


2 - Shall throw 

uicc. access. UlCCException with 

reason code NO_EF_SELECTED. 




16 


No selection of non-reachable file 

1 - select MF, 
fid = 3F00 

2 - select EFcaro, 
fid= Ox6F09 


2 - Shall throw 

uicc. access. UlCCException with 

reason code FILE NOT FOUND. 
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17 


No record is selected after selecting linear 
fixed EF 

1- select MF, 
fid = 3F00 

2- select DFiest, 
fid=llll 

3- select EFlaro, 
fid=6F0C 

4 - recNumber = 

mode = REC_ACC_MODE_ CURRENT 

readRecord () 


4 - Shall throw uicc.access.UICC 
Exception with reason code 
RECORD NOT FOUND. 




18 


Record pointer in selected cyclic EF 

1- select MF, 
fid = 3F00 

2- select DFiest, 
fid=llll 

3- select EFcaro, 
fid=6F09 

4- byte[] datal = { 1,2,3 } 
mode = REC_ACC_MODE_PREVIOUS 
updateRecord (datal) 

5- select EFcaro 
fid = 6F09 
select 

mode = REC_ACC_MODE_PREVIOUS 
readRecord () 
readRecord (data2 ) 
compare datal to data2 

6- restore original data of EFcaro 


5 - The contents of datal and data2 
shall be identical. 




19 


EF not selected after ADF/DF selection 

1- get an AdminFileView 
AdminFileViewBuilder . getXheAdminFileView 

(AID_ADF1, CLEAR_ON_RESET) 

2- select ADF, 
fid = 7FFF 
select EFuicc, 
fid = 2FF0 

3 - select ADF 
fid = 7FFF 
select 
readBinary () 


3 - Shall throw 

uicc.access.UICCException with 
reason code NO_EF_SELECTED. 




20 


Reselection 

1- Using the ADF FileView 
select ADF, fid=7FFF 
select ADF, fid=7FFF 

2- Using the UICC FileView 
select MF, fid=3F00 
select MF, fid=3F00 

3- select DFiest, fid=llll 
select DFiest, fid=llll 

5- select EFiam, fid=6F16 
select EFiAAA, fid=6F16 


No exceptions shall be thrown 




21 


Security attributes 

1- Using the ADF FileView 
select ADF, fid=7FFF 
select DFiest, fid=llll 
select EFlarri, fid=6FAl 

2- Using the UICC FileView 
select MF, fid=3F00 
select DFiest, fid=llll 
select EFiARR3, fid=6FB3 


1- fcp[] shall contain the following TLV 
8B 03 AC 00 01 or 

8B 06 AC 00 00 01 01 01 

2- fcp[] shall contain the following TLV 
8B 03 AC 00 03 or 

88 06 AC 00 00 03 01 03 





5.3.1 .6 Method select (short fid) 

Test Area Reference: Api_4_Afv_Slcts. 

5.3.1.6.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 
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public public void select (short fid) 
throws UICCException 

5.3.1 .6.1 .1 Normal execution 

• CRRNl : Selects a file of the UICC file system or of an ADF file system by file identifier. 

• CRRN2: Allows to update the current file without handling the Select Response. 

• CRRN3: After selecting a ADF/MF/DF no EF is selected. 

• CRRN4: After selecting a linear fixed EF no record is selected. 

• CRRN5: Any file can be selected by FID which is an immediate child of the current directory. 

• CRRN6: Any DF can be selected by FID which is an immediate child of the parent of the current DF. 

• CRRN7: The parent of the current directory can be selected by the FID. 

• CRRN8: The ADF of the current active application can be selected by the FID. 

• CRRN9: The ADF/MF/EF can always be self selected. 

• CRRNIO: The file context associated with the File View object is changed after successful execution. 

5.3.1.6.1.2 Parameter errors 
No requirements. 

5.3.1.6.1.3 Context errors 

• CRRCl: If the file with a File Identifier which matches fid could not be found according to the selection rule 
listed in CCRN3, an instance of UICCException shall be thrown. The reason code shall be 
UICCException.FILE_NOT_FOUND. 

• CRRC2: If the file with a File Identifier which matches fid could not be found according to the selection rule 
listed in CCRN4, an instance of UICCException shall be thrown. The reason code shall be 
UICCException.FILE_NOT_FOUND. 

• CRRC3: If the file with a File Identifier which matches fid could not be found according to the selection rule 
listed in CCRN5, an instance of UICCException shall be thrown. The reason code shall be 
UICCException.FILE_NOT_FOUND. 

• CRRC4: If the file with a File Identifier which matches fid could not be found according to the selection rule 
listed in CCRN6, an instance of UICCException shall be thrown. The reason code shall be 
UICCException.FILE_NOT_FOUND. 

• CRRC5: If the method call causes a memory problem (e.g. memory access error), an instance of 
UICCException shall be thrown. The reason code shall be UICCException.MEMORY_PROBLEM. 

• CRRC6: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
UICCException shall be thrown. The reason code shall be UICCException.INTERNAL_ERROR. 

5.3.1.6.2 Test area files 

Test Source: Test_Api_4_Afv_Slcts.java. 
Test Applet: Api_4_Afv_Slcts_l.java. 

Cap File: api_4_Afv_slcts.cap. 

5.3.1.6.3 Test coverage 

I CRR number I Test case number I 
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N1 


1,2 


N2 


5 


N3 


5 


N4 


6 


N5 


1,2 


N6 


1,2 


N7 


1,2 


N8 


1,2 


N9 


4 


N10 


Tested in Api 1 Cont, test case 1 and 2 


C1 


3 


C2 


3 


C3 


3 


C4 


3 


C5 


Not testable 


C6 


Not testable 



5.3.1.6.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Get an AdminFileView object, UICC file 
system 

1- get an AdminFileView 

AdminFileViewBuilder . getTheUICCAdminFil 
eView (CLEAR_ON_RESET) 






1 


Selection possibilities 

1- select EFuicc, fid=2FF0 

2- select DFiest, fid=llll 

3- select EFcnu, fid=6F05 

4- select EFiaM, fid=6F16 

5- select DFsnB_iEST, fid=2211 

6- select DFiest, fid=llll 

7- select EFiaaa, fid=6F16 

8- select DFiest, fid=llll 

9- select MF, fid=3F00 

10- select DFiest, fid=llll 

11- select EFiASA, fid=6F16 

12- select MF, fid=3F00 


No exception shall be thrown 




2 


Selection possibilities, ADF1 

1- get an AdminFileView 

AdminFileViewBuilder . getTheAdminFileVie 
w (AID_ADF1, CLEAR_ON_RESET) 

2- select EFuicc, fid=2FF0 

3- select DFiest, fid=llll 

4- select EFcnu, fid=6F05 

5- select EFiaM, fid=6F16 

6- select DFsnB_iEST, fid=2211 

7- select DFiest, fid=llll 

8- select EFiaaa, fid=6F16 

9- select DFiest, fid=llll 


No exception shall be thrown 




3 


No selection of unreachable file 

1- get an AdminFileView 

AdminFileViewBuilder .getTheUICCAdminFil 
eView (CLEAR_ON_RESET) 

2- select EFcnu, fid=6F05 

3- select DFiest, fid=llll 

4- select EFiaa, fid=2222 

5- select EFcnu, fid=6F05 

6- select DFsnB_iEST, fid=2211 

7- select EFiaa, fid=2222 

8- select DFielecom, fid=7F10 


2- A 

UICCException.FILE_NOT_FOUND 

shall be thrown. 

3- No exception shall be thrown 

4- A 

UICCException.FILE_NOT_FOUND 

shall be thrown. 

5- No exception shall be thrown 

6- No exception shall be thrown 

7- No exception shall be thrown 
8- A 

UICCException.FILE_NOT_FOUND 
shall be thrown. 




4 


Self selection 
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1- select MF, fid=3F00 

2- select MF, fid=3F00 


2- No exception shall be thrown 






3- select DFiest, fid=llll 

4- select DFiest, fid=llll 


4- No exception shall be thrown 






5- select EFisja, fid=6F16 

6- select EFisaa, fid=6F16 


6- No exception shall be thrown 






7- get an AdminFileView 








AdminFileViewBuilder . getTheAdminFileVie 
w (AID_ADF1, CLEAR_ON_RESET) 


8- No exception shall be thrown 






8- select ADF, fid=7FFF 

9- select ADF, fid=7FFF 


9- No exception shall be thrown 




5 


EF not selected after MF/DF selection 


2- A 

UICCException.NO_EF_SELECTED 
shall be thrown 
4- A 

UICCException.NO_EF_SELECTED 
shall be thrown 






1- select MF, fid=3F00 

2- updateRecord ( ) 

3- select DFiest, fid=llll 

4- updateRecord 




6 


No record is selected after selecting linear 
fixed EF 

1- select MF, 
fid = 3F00 

2- select DFiest, 

3- select EFlsro, 

4 - recNumber = 

mode = REC_ACC_MODE_ CURRENT 

readRecord () 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 

4 - Shall throw uicc.access.UICC 
Exception with reason code 
RECORD_NOT_FOUND. 

5 - No exception shall be thrown. 

6 - Shall throw uicc.access.UICC 






5- select EFcaro, 

6 - recNumber = 

mode = RFC ACC MODE CURRENT 


Exception with reason code 
RECORD NOT FOUND. 






readRecord ( ) 







5.3.1.7 Method status 

Test Area Reference: Api_4_Afv_Stat. 



5.3.1.7.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

public short status (byte [ ] fcp, 

short fcpOffset, 
short fcpLength) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
UICCException 



5.3.1.7.1.1 



Normal execution 



• CRRNl : The method returns the File Control Parameter of the current selected DF/MF or ADF as defined in 

TS 102 221 [6]. 

• CRRN2: If the fcpLength is greater than the length of the response, the whole response is copied into the 
fcp buffer and the length of the response is returned by the method. 

• CRRN3: f the f cplength is smaller than the length of the response, the first part of the response is copied 
into the fcp buffer and the fcpLength is returned by the method. 

5.3.1.7.1.2 Parameter errors 

• CRRPl : If the array fcp is null, an instance of NullPointerException shall be thrown. 

• CRRP2: If fcpOffset is negative, an instance of ArraylndexOutOfBoundsException shall be thrown. 

• CRRP3: If fcpLength is negative, an instance of ArraylndexOutOfBoundsException shall be thrown. 
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CRRP4: If fcpOffset+fcpLength is greater than fcp.length an ArraylndexOutOfBoundsException shall be 
thrown. 



5.3.1.7.1.3 



Context errors 



CRRCl: If the method call causes a memory problem (e.g. memory access error), an instance of 
UICCException shall be thrown. The reason code shall be UICCException.MEMORY_PROBLEM. 

CRRC2: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
UICCException shall be thrown. The reason code shall be UICCException.INTERNAL_ERROR. 



5.3.1.7.2 

Test Source: 
Test Applet: 
Cap File: 



Test area files 

Test_Api_4_Afv_Stat.j ava. 
Api_4_Afv_Stat_l .Java. 
Api_4_Afv_Stat.cap. 



5.3.1.7.3 



Test coverage 



CRR number 


Test case number 


N1 


1,2, 3, 4, 5, 11 


N2 


2,3 


N3 


1,4 


PI 


6 


P2 


7 


P3 


8 


P4 


9, 10 


CI 


Not testable 


C2 


Not testable 



5.3.1.7.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Status of MF 

1- Get an AdminFileView object, UICC 
file get an AdminFileView 

FlleVlew . getTheUICCAdmlnFlleVlew (CLEAR_ 
ON_RESET) 

2- select MF 

byte[] fcp = new byte[127] 
fcp[0:2]= OxCC 
fcpOffset = 3 
fcpLength = 11 
status 


2- Shall return 11. 

The first 3 bytes of fcp[] shall contain 

OxCC. 

fcp[] shall contain following TLVs: 

1 . 82 02 38/78 21 //file descriptor 

2. 83 02 3F 00 //file ID 




2 


Status after select EFtaru in MF 

1 - select DFtest 
select EFtaru, fid = 6F03 
fcpOffset = 
fcpLength = 127 
select 
status 


1- Shall return at least 19. 
fcp[] shall contain following TLVs: 
1 . 82 02 38/78 21 //file descriptor 
2.83 02 11 11 //file ID 




3 


Status of DFtelecom 

1 - fid = 7F10 
fcpOffset = 
fcpLength = 127 
status 


1 - 

Shall return at least 17 and the entire 
structure of the file control parameters. 
The file identifier shall be contain the 
fid of DFtelecom. 




4 


Status DFtelecom 

Select DFtelecom, fid=7F10 
fcpOffset = 
fcpLength = 11 
status 


Shall return 11. 

fcp shall contain the first 1 1 bytes of 
the FCP structure starting at index 0. 
fcp[] shall contain following TLVs: 
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Id 


Description 


API Expectation 


APDU Expectation 






1 . 82 02 38/78 21 //file descriptor 

2. 83 02 7F 10 //file id 




5 


Status ADF1 

Select ADF, fid=7FFF 
fcpOffset = 
fcpLength =12 7 


Sliall return at least 27 

fcp[] shall contain the entire FCP 

structure 

fcp[] shall contain following TLVs: 

1.82 02 78 21 //file descriptor 

2. 84 10 AG 00 00 00 09 00 05 FF FF 
FF FF 89 60 00 00 00 //DF Name 

3. 8A 01 05 //life cycle 




6 


fcp is null 

byte[] nullBuffer = null 
fcpOffset = 
fcpLength = 34 
status 


Shall throw 
java.lang.NullPointerException. 




7 


fcpOffset < 

fcpOffset = -1 
fcpLength = 34 
status 


Shall throw 

java.lang.ArraylndexOutOfBoundsExce 

ption. 




8 


fcpLength < 

fcpOffset = 
fcpLength = -1 
status {) 


Shall throw 

java.lang.ArraylndexOutOfBoundsExce 

ption. 




9 


fcpOffset + fcpLength > fcp.length 

fcpOffset = fcp.length-1 
fcpLength = 15 
status 


Shall throw 

java.lang.ArraylndexOutOfBoundsExce 

ption. 




10 


fcpOffset + fcpLength > fcp.length 

fcpOffset = fcp.length+1 
fcpLength = 
status 


Shall throw 

java.lang.ArraylndexOutOfBoundsExce 

ption. 




11 


Security attributes 

1- Using the ADF FileView 
select ADF, fid=7FFF 
select DFtest, 

select DFaRE2, 

2- Using the UICC FileView 
select MF, fid=3F00 
select DFiEST, 

select DFaRR4, 


1- fcp[] shall contain the following TLV 
8B 03 AC 00 02 or 

8B 06 AC 00 00 02 01 02 

2- fcp[] shall contain the following TLV 
8B 03 AC 00 04 or 

8B 06 AC 00 00 04 01 04 





5.3.1.8 Method readBinary 

Test Area Reference: Api_4_Afv_Redb. 



5.3.1.8.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

public short readBinary (short fileOffset, 

byte [ ] resp, 
short respOffset, 
short respLength) 
throws Java . lang . NullPointerException, 

Java .lang . Array I ndexOut Of Bounds Except ion, 
UICCException 

5.3.1.8.1.1 Normal execution 

• CRRNl:. Reads the data bytes of the current transparent EF, as defined in TS 102 221 [6]. 
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CRRN2: The sum of respOffset plus respLength is returned, and the data bytes of the currently selected 
transparent file are returned in resp. 



5.3.1.8.1.2 



Parameter errors 



CRRPl: If fileOffset is negative, an instance of UICCException.OUT_OF_FILE_BOUND ARIES shall be 
thrown. 

CRRP2: If respOffset is negative, an instance of ArraylndexOutOfBoundsException shall be thrown. 

CRRP3: If respLength is negative, an instace of ArraylndexOutOfBoundsException shall be thrown. 

CRRP4: If the array resp is null, an instance of NullPointerException shall be thrown. 

CRRP5: If respOffset plus respLength is greater than the length of the array resp. length, an instance of 
ArraylndexOutOfBoundsException shall be thrown and no read is performed. 

CRRP6: If fileOffset plus respLength exceeds the length of the file, an instance of UICCException shall be 
thrown. The reason code shall be UICCException.OUT_OF_FILE_BOUND ARIES. 



5.3.1.8.1.3 



Context errors 



CRRCl: If the method call causes an error to occur that is not expected and thus not handled, an instace of 
UICCException shall be thrown. The reason code shall be UICCException.INTERNAL_ERROR. 

CRRC2: If the currently selected EF is not transparent, an instance of UICCException shall be thrown. The 
reason code shall be UICCException.COMMANDJNCOMPATIBLE. 

CRRC3: If the calling applet does not fulfil the access condition, READ, to perform this function, an instance 
of UICCException shall be thrown. The reason code shall be 
UICCException.SECURITY_STATUS_NOT_SATISFIED. 

CRRC4: If the currently selected EF is deactivated and the file status of the EF does not allow for the reading 
of an deactivated file, an instance of UICCException shall be thrown. The reason code shall be 
UICCException.REF_DAT_INVALIDATED. 

CRRC5:If the calling applet has currently no EF selected, an instance of UICCException shall be thrown. The 
reason code shall be UICCException. NO_EF_SELECTED. 



5.3.1.8.2 

Test Source: 
Test Applet: 
Cap File: 



Test area files 

Test_Api_4_Afv_Redb .j ava. 
Api_4_Afv_Redb_ Lj ava. 
api_4_Afv_redb.cap. 



5.3.1.8.3 



Test coverage 



CRR number 


Test case number 


N1 


1,2 


N2 


1,2 


P1 


3 


P2 


6 


P3 


7 


P4 


5 


P5 


8 


P6 


4 


C1 


Not testable 


C2 


9 


C3 


10 


C4 


11 


C5 


12 
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5.3.1.8.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Read from EFtaru 

1- select DFiEST, fid=llll 
select EFtaru, fid=6F03 

2- fileOffset = 
resp. length = 260 
resp[0:259] = 0x55 
respOffset = 10 
respLength = 250 
readBinary () 


2 - shall return 20. 

resp shall contain the contents of 

EFtaru Starting at index 1 0. 

<Description of resp: 

55 55 55 55 55 55 55 55 55 55 

FFFFFFFFFFFF.. .. FF> 




2 


Read from EFtaru 

fileOffset = 0x80 
resp. length = 260 
resp[0:259] = 0x55 
respOffset = 5 
respLength = 0x80 
readBinary () 


shall return 15 

resp shall contain the last 5 bytes of 

EFtaru Starting at index 1 0. 

<Description of resp: 

55 55 55 55 55 55 55 55 55 55 

FF FF FF FF FF ... 55 55 .. .. 55 FF FF 

... FF> 




3 


FileOffset is negative 

fileOffset = -1 
respOffset = 
respLength = 10 
readBinary () 


Shall throw uicc.access.UICC 
Exception with reason code 
OUT_OF_FILE_BOUNDARIES. 




4 


FileOffset + respLength > EF length 

fileOffset = 259 
respOffset = 
respLength = 2 
readBinary () 


Shall throw uicc.access.UICC 
Exception with reason code 
OUT_OF_FILE_BOUNDARIES. 




5 


resp[] is null 

fileOffset = 
resp = null 
respOffset = 
respLength = 10 
readBinary () 


Shall throw 
java.lang.NullPointerException. 




6 


respOffset < 

fileOffset = 
respOffset = -1 
respLength = 10 
readBinary () 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsException. 




7 


respLength < 

fileOffset = 
respOffset = 
respLength = -1 
readBinary () 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsException. 




8 


RespOffset + respLength > resp.length 

fileOffset = 
resp.length = 20 
respOffset = 10 
respLength = 11 
readBinary () 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsException. 




9 


EF is not Transparent 

1- select EFlaru, fid=6F0C 

2- fileOffset = 
respOffset = 
respLength = 1 
readBinary {) 


2 - Shall throw uicc.access.UICC 
Exception with reason code 
COMMANDJNCOMPATIBLE. 




10 


Access condition not fulfilled 

1- select EFiEsc, fid=6F0E 

2- fileOffset = 
respOffset = 
respLength = 1 
readBinary () 


2- Shall throw uicc.access.UICC 
Exception with reason code 
SECURITY STATUS NOT SATISFIE 
D. 




11 


EF is deactivated 

1 - select EFiann, fid=6F03 

2 - deactivateFile 

3 - readBinary {) 

4 - activateFileO ) 


3 - Shall throw 

uicc. access. UlCCException with 

reason code 

REF DATA INVALIDATED. 
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Id 


Description 


API Expectation 


APDU Expectation 










12 


No EF selected 

1- select DFiEST fid=llll 
2 readBinaryO 


2 - Shall throw 

uicc. access. UlCCException with 

reason code NO EF SELECTED. 





5.3.1.9 Method updateBinary 

Test Area Reference: Api_4_Afv_Updb. 



5.3.1.9.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

public void updateBinary (short fileOffset, 

byte [ ] data, 
short dataOffset, 
short dataLength) 
throws Java . lang . NullPointerException, 

Java .lang . Array IndexOutOfBoundsExcept ion, 
UlCCException 

5.3.1.9.1.1 Normal execution 

• CRRNl : Updated the data bytes of the current selected transparent EF. 

5.3.1.9.1.2 Parameter errors 

• CRRPl: If recOffset is less than 0, an instance of UlCCException shall be thrown. The reason code shall be 
UICCException.OUT_OF_FILE_BOUNDARIES. 

• CRRP2: : If fileOffset plus dataLength exceeds the length of the file, an instance of UlCCException shall be 
thrown. The reason code shall be UICCException.OUT_OF_FILE_BOUND ARIES. 

• CRRP3: If the array data is null, an instance of NullPointerException shall be thrown. 

• CRRP4: If dataOffset is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

• CRRP5: If dataLength is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

• CRRP6: If dataOffset plus dataLength greater than the length of the array data. length an instance of 
ArraylndexOutOfBoundsException shall be thrown. 



5.3.1.9.1.3 



Context errors 



CRRCl: If the calling applet has currently no EF selected, an instance of UlCCException shall be thrown. The 
reason code shall be UICCException.NO_EF_SELECTED. 

CRRC2: If the currently selected EF is not transparent, an instance of UlCCException shall be thrown. The 
reason code shall be UICCException.COMMANDJNCOMPATIBLE. 

CRRC3: If the calling applet does not fulfil the access condition, UPDATE, to perform this function, an 
instance of UlCCException shall be thrown. The reason code shall be 
UICCException.SECURITY_STATUS_NOT_SATISFIED. 

CRRC4: If the currently selected EF is deactivated and the file status of the EF does not allow for updating of 
a deactivated file, an instance of UlCCException shall be thrown. The reason code shall be 
UICCException.REF_DATA_INVALIDATED. 

CRRC5: If the method call causes a memory problem (e.g. memory access error), an instance of 
UlCCException shall be thrown. The reason code shall be UICCException.MEMORY_PROBLEM. 
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• CRRC6: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
UICCException shall be thrown. The reason code shall be UICCException.INTERNAL_ERROR. 



5.3.1.9.2 

Test Source: 
Test Applet: 
Cap File: 

5.3.1.9.3 



Test area files 

Test_Api_4_Afv_Updb.java. 
Api_4_Afv_Updb _l.java. 
api_4_Afv_updb . cap . 

Test coverage 



CRR number 


Test case number 


N1 


2,3 


P1 


4 


P2 


5 


P3 


6 


P4 


7 


P5 


8 


P6 


9 


C1 


1 


C2 


10 


C3 


11 


C4 


12 


C5, 


Not Testable 


C6 


Not Testable 



5.3.1.9.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Get the UICC FileView 

AdminFileViewBuilder .getTheUICCAdminFll 
eView (CLEAR_ON_RESET) 







1 


No EF selected 

fileOffset = 
byte[] data = new byte [20] 
data[0] = '55' 
dataOffset = 
dataLength = 10 
updateBinary () 


Shall throw uicc.access.UICC 
Exception with reason code 
NO_EF_SELECTED. 


1 


2 


Update Transparent EF 

1- select DFiEST, fid = 1111 

2- select EFiaRo, fid = 6F03 

3- fileOffset = 3 
data[0] = '55' 
dataOffset = 
dataLength = 1 
updateBinary () 

4- fileOffset = 3 
respOffset = 
respLength = 1 
readBinary () 


1- No exception shall be thrown. 

2- No exception shall be thrown. 

3- No exception shall be thrown. 

4- No exception shall be thrown. 
Data in resp[0] shall be '55'. 




3 


fileOffset = 254 

1- fileOffset = 254 
data[0] = '55' 
data[l] = 'AA' 
data[2] = '66' 
dataOffset = 
dataLength = 3 
updateBinary () 

2- fileOffset = 254 
respOffset = 
respLength = 3 
readBinary () 


1- No exception shall be thrown. 

2- No exception shall be thrown. 
Data in resp shall be 

resp[0] = '55' 
resp[1 ] = 'AA' 
resp[2] = '66' 




4 


Offset into File out of bounds 

fileOffset = -1 
dataOffset = 


Shall throw 

uicc.access. UICCException with 
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Id 


Description 


API Expectation 


APDU Expectation 




dataLength = 10 
updateBinary () 


reason code 

OUT OF FILE BOUNDARIES. 




5 


fileOffset + dataLength > EF length 

fileOffset = 259 
dataOffset = 
dataLength = 2 
updateBinary () 


Shall throw uicc.access.UICC 
Exception with reason code 
OUT_OF_FILE_BOUNDARIES. 




6 


data is null 

byte[] nullBuffer = null 
fileOffset = 
dataOffset = 
dataLength = 10 
updateBinary ( ) 


Shall throw 
java.lang.NullPointerException. 




7 


dataOffset < 

fileOffset = 
dataOffset = -1 
dataLength = 10 
updateBinary () 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsException. 




8 


dataLength < 

fileOffset = 
dataOffset = 
dataLength = -1 
updateBinary () 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsException. 




9 


dataOffset + dataLength > data.length 

fileOffset = 
dataOffset = 10 
dataLength = 11 
updateBinary () 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsException. 




10 


EF is not Transparent 

1- select DFiEST, fid = 1111 

2- select DFlaru, fid = 6F0C 
3 - fileOffset = 
data[0] = '55' 
dataOffset = 
dataLength = 1 
updateBinary () 


1- No exception shall be thrown. 

2- No exception shall be thrown. 

3- Shall throw uicc.access.UICC 
Exception with reason code 
COMMANDJNCOMPATIBLE. 




11 


Access condition not fulfilled 

1- select DFiEST, fid = 1111 

2- select EF™o, fid = 6F02 

3- fileOffset = 
data[0] = '55' 
dataOffset = 
dataLength = 1 
updateBinary () 


1- No exception shall be thrown. 

2- No exception shall be thrown. 

3- Shall throw 

uicc. access. UlCCException with 

reason code 

SECURITY STATUS NOT SATISFIE 

D. 




12 


EF is deactivated 

1- select EFiNR, fid = 6F01 
deactiveFile () 

2- fileOffset = 
data[0] = '55' 
dataOffset = 
dataLength = 1 
updateBinary ( ) 

3- activateFile ( ) 


1- No exception shall be thrown. 

2- Shall throw 

uicc. access. UlCCException with 
reason code 
REF_DATA_INVALIDATED 

3- No exception shall be thrown. 





5.3.1.10 Method read Record 

Test Area Reference: Api_4_Afv_Redr. 



5.3.1.10.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

public short readRecord (short recNumber^ 

byte mode, 
short recOffset, 
byte [ ] resp, 
short respOffset, 
short respLength) 
throws Java . lang . NullPointerException, 

Java .lang .ArraylndexOutOfBoundsException, 
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UICCException 

5.3.1.10.1.1 Normal execution 

• CRRN 1 : Reads a record or a part of record of a current linear fixed or cyclic EF into byte array resp and the 
sum of respOffset plus respLength is returned. 

• CRRN2: If the access mode is REC_ACC_MODE_CURRENT the current record will be read and the current 
record pointer shall not be changed. 

• CRRN3: If the access mode is REC_ACC_MODE_ ABSOLUTE the record addressed by recNumber will be 
read and the current record pointer shall not be changed. 

• CRRN4: If the access mode is REC_ACC_MODE_NEXT the next record relative to the current selected 
record will be selected and read. The record pointer will be incremented. 

• CRRN5: If the access mode is REC_ACC_MODE_NEXT and no current record is selected, the first record 

will be selected and read. The record pointer will be incremented. 

• CRRN6: If the access mode is REC_ACC_MODE NEXT and the current record pointer, of a cyclic EF, is set 
to the last record, the record pointer is set to the first record and the record is read. 

• CRRN7: If the access mode is REC_ACC_MODE_PREVIOUS the previous record relative to the current 
selected record will be selected and read. 

• CRRN8: If the access mode is REC_ACC_MODE PREVIOUS and no current record is selected, the last 
record will be selected and read. 

• CRRN9:If the access mode is REC_ACC_MODE_PREVIOUS and the current record pointer of a cychc EF is 
set to the first record, the record pointer is set to the last record in this EF and this record shall be read. 

• CRRN 10: The current record pointer of any other applet shall not be changed. 

5.3.1.10.1.2 Parameter errors 

• CRRPl : If the currently selected EF is hnear fixed and the access mode is REC_ACC_MODE_ABSOLUTE 
and recNumber is less than or greater than records available, an instance of UICCException shall be thrown. 
The reason code shall be UICCException.RECORD_NOT_FOUND. 

• CRRP2: If the currently selected EF is linear fixed and the access mode is REC_ACC_MODE_CURRENT, 
recNumber is and there is no current record selected, an instance of UICCException shall be thrown. The 
reason code shall be UICCException. RECORD_NOT_FOUND. 

• CRRP3: If the currently selected EF is hnear fixed and the access mode is REC_ACC_MODE_NEXT and the 
current record pointer is set to the last record, an instance of UICCException shall be thrown. The reason code 
shall be UICCException.RECORD_ NOT_FOUND. 

• CRRP4: If the currently selected EF is hnear fixed and the access mode is REC_ACC_MODE_PREVIOUS 
and the current record pointer is set to the first record, an instance of UICCException shall be thrown. The 
reason code shall be UICCException.RECORD_ NOT_FOUND. 

• CRRP5: If the specified offset into the selected record recOffset is less than 0, an instance of UICCException 
shall be thrown. The reason code shall be UICCException.OUT_OF_RECORD_BOUND ARIES. 

• CRRP6: If recOffset plus respLength is greater than the record length, an instance of UICCException shall be 
thrown. The reason code shall be UICC Exception.OUT_OF_RECORD_BOUND ARIES. 

• CRRP7: If the access mode is not between 2 and 4 (2 = REC_ACC_MODE_NEXT, etc.), an instance of 
UICCException shall be thrown. The reason code shall be UICC Exception.INVALID_MODE. 

• CRRP8: If the array resp is null, an instance of NullPointerException shall be thrown. 

• CRRP9: If respOffset is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 
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CRRPIO: If respLength is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

CRRPl 1 : If respOffset plus respLength is greater than the length of the array resp. length, or respOffset equals 
resp. length, an instance of ArraylndexOutOfBoundsException shall be thrown. 



5.3.1.10.1.3 



Context errors 



CRRCl: If the calling applet has currently no EF selected, an instance of UICCException shall be thrown. The 
reason code shall be UICCException. NO_EF_SELECTED. 

CRRC2: If the currently selected EF is neither linear fixed nor cyclic, an instance of UICCException shall be 
thrown. The reason code shall be UICCException.COMMANDJNCOMPATIBLE. 

CRRC3: If the calling applet does not fulfil the access condition, READ, to perform this function, an instance 
of UICCException shall be thrown. The reason code shall be 
UICCException.SECURITY_STATUS_NOT_SATISFIED. 

CRRC4: If the currently selected EF is invalidated and the file status of the EF does not allow for reading an 
invalidated file, an instance of UICCException shall be thrown. The reason code shall be 
UICCException.REF_DATA_INVALIDATED. 

CRRC5: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
UICCException shall be thrown. The reason code shall be UICCException.INTERNAL_ERROR. 



5.3.1.10.2 

Test Source: 
Test Applet: 
Cap File: 



Test area files 

Test_Api_4_Afv_Redr.j ava. 
Api_4_Afv_Rredr_l .Java. 
api_4_Afv_redr.cap. 



5.3.1.10.3 



Test coverage 



CRR number 


Test case number 


N1 


2,3,4,5,6,8,9, 10, 11, 12, 13 


N2 


3,9 


N3 


2,8 


N4 


4,5, 10, 11 


N5 


4, 11 


N6 


11 


N7 


6,7, 12, 13 


N8 


6, 13 


N9 


12 


N10 




PI 


14 


P2 


15 


P3 


5 


P4 


7 


P5 


16 


P6 


17 


P7 


18 


P8 


19 


P9 


20 


P10 


21 


P11 


22 


CI 


1 


C2 


23 


C3 


24 


C4 


25 


C5 


Not testable 
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5.3.1.10.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


No EF selected 

1- select DFiEST, fid=llll 

2- recNumber = 1 

mode = REC_ACC_MODE_ABSOLUTE 

recOffset = 

byte[] resp = new byte[20] 

respOffset = 

respLength = 10 

readRecord {) 


2-Shall throw 

uicc . access .UICCException with 

reason code NO_EF_SELECTED . 




2 


Read Absolute from Linear Fixed EF 

1 - select EFlaeu, fid=6F0c 
// Record pointer not set. 

2 - recNumber = 2 

mode = REC_ACC_MODE_ABSOLUTE 

recOffset = 

respOffset = 

respLength = 4 

readRecord () 

3- recNumber = 

mode = REC_ACC_MODE_NEXT 

recOffset = 

respOffset = 

respLength = 4 

readRecord () 


2 - resp shall be: 
resp={OxAA, OxAA, OxAA, OxAA} 

3- resp shall be; 
Resp={0x55, 0x55, 0x55, 0x55} 




3 


Read Current from Linear Fixed EF 

//record pointer shall not be changed 

1- recNumber = 

mode = REC_ACC_MODE_CURRENT 

recOffset = 

respOffset = 

respLength = 4 

readRecord ( ) 


resp shall be: 

resp={0x55, 0x55, 0x55, 0x55} 




4 


Read Next from Linear Fixed EF 

1- select EFlaru, fid=6F0c 
//no record selected 
recNumber = 

mode = REC_ACC_MODE_NEXT 
recOffset = 
respOffset = 
respLength = 4 
readRecord () 

2- recNumber = 

mode = REC„ACC_MODE_NEXT 
recOffset = 
respOffset = 
respLength = 4 
readRecord ( ) 


1- resp shall be: 

resp={ 0x55, 0x55, 0x55, 0x55} 

2- resp shall be: 
resp={OxAA, OxAA, OxAA, OxAA} 




5 


Read Next from Linear Fixed EF 

recNumber = 
mode = REC_ACC_MODE_NEXT 
recOffset = 
respOffset = 
respLength = 4 
readRecord {) 


Shall throw uicc . access .UICC 
Exception with reason code 
RECORD_NOT_FOUND . 
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Id 


Description 


API Expectation 


APDU Expectation 


6 


Read Previous from Linear Fixed EF 

1- recNumber = 

mode = REC„ACC„MODE_PREVIOUS 
recOffset = 
respOffset = 
respLength = 4 
readRecord () 

2- select EFlaru, fid=6F0c 
//no record selected 
recNumber = 

mode = REC_ACC_MODE_PREVIOUS 
recOffset = 
respOffset = 
respLength = 4 
readRecord () 

3- Set the record to the first record 
by reading the file 

recNumber = 

mode = REC„ACC_MODE_PREVIOUS 

recOffset = 

respOffset = 

respLength = 4 


1- resp shall be; 

resp={ 0x55, 0x55, 0x55, 0x55} 

2- resp shall be; 
resp={OxAA, OxAA, OxAA, OxAA} 

3- resp={0x55, 0x55, 0x55, 0x55} 




7 


Read Previous from Linear Fixed EF 

recNumber = 

mode = REC_ACC_MODE_PREVIOUS 

recOffset = 

respOffset = 

respLength = 4 

readRecord {) 


Shall throw 

uicc . access .UICCException with 

reason code RECORD _NOT_FOUND . 




8 


Read Absolute from Cyclic EF 

1 select EFcARo, fid = 6F09 

2- recNumber = 2 

mode = REC_ACC_MODE_ABSOLUTE 
recOffset = 
respOffset = 
respLength = 3 
readRecord ( ) 

3- recNumber = 1 
readRecord ( ) 

4- Read the file in next mode to set the 
record pointer to the first position. 
recNumber = 

mode = REC_ACC_MODE_NEXT 
recOffset = 
respOffset = 
respLength = 3 
readRecord ( ) 


2 - resp shall be; 
resp={OxAA, OxAA, OxAA} 

3 - resp shall be; 
resp={ OxAA, OxAA, OxAA} 

4 - resp shall be; 
resp={OxAA, OxAA, OxAA} 




9 


Read Current from Cyclic EF 

//record pointer shall not be changed 

//from testcase before 

1- recNumber = 

mode = REC_ACC_MODE_CURRENT 

recOffset = 

respOffset = 

respLength = 3 

readRecord () 


1- resp shall be; 
resp= { OxAA, OxAA, OxAA} 




10 


Read Next from Cyclic EF 

recNumber = 
mode = REC_ACC_MODE_NEXT 
recOffset = 
respOffset = 
respLength = 3 
readRecord () 


resp shall be; 
resp={OxAA, OxAA, OxAA} 
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Id 


Description 


API Expectation 


APDU Expectation 


11 


Read Next from Cyclic EF 

1- recNumber = 
mode = REC„ACC„MODE_NEXT 
recOffset = 
respOffset = 
respLength = 3 


1- resp shall be: 
resp={0x55, 0x55, 0x55} 






readRecord () 

2- select EFcaro, fid = 6F09 


2- Shall throw 






//no rec selected 


uicc. access .UICCException with 






recNumber = 


reason code RECORD_NOT_FOUND . 






mode = REC_ACC_MODE_NEXT 








recOffset = 








respOffset = 








respLength = 3 
readRecord () 






12 


Read Previous from Cyclic EF 

1- recNumber = 

mode = REC_ACC_MODE_PREVIOUS 








recOffset = 
respOffset = 


1- resp shall be; 
resp={OxAA, OxAA, OxAA} 






respLength = 3 








readRecord ( ) 






13 


Read Previous from Cyclic EF 

1- recNumber = 

mode = REC_ACC_MODE_PREVIOUS 

recOffset = 








respOffset = 
respLength = 3 
readRecord () 


1- resp shall be: 
resp={0x55, 0x55, 0x55} 






2- select EFcaro, fid = 6F09 








// no rec selected 








recNumber = 








mode = REC_ACC_M0DE_PREVI0US 








recOffset = 








respOffset = 
respLength = 3 


2- resp shall be: 
resp={OxAA, OxAA, OxAA} 






readRecord ( ) 






14 


Read Absolute from Linear Fixed EF beyond 
Records 

1- select EFlsro, fid=6F0C 

2- recNumber = -1 

mode = REC_ACC_MODE_ABSOLUTE 
recOffset = 


2- Shall throw an 

uicc . access .UICCException with 

reason code 

UICCException . RECORD_NOT_FOUND . 






respOffset = 
respLength = 4 
readRecord () 
3- recNumber = 3 
readRecord ( ) 


3- Shall throw an 

uicc . access . UICCException with 

reason code 

UICCException . RECORD_NOT_FOUND . 




15 


No current record in linear fixed EF, read 
current 

1- select EFlaro, fid=6F0C // No current 








record 

2- recNumber =0 // curr rec 
mode = REC„ACC_MODE_CURRENT 
recOffset = 


2 - Shall throw uicc . access . UICC 
Exception with reason code 
RECORD_NOT_FOUND . 






respOffset = 
respLength = 4 








readRecord () 






16 


recOffset < 








1- select EFlaro, fid=6F0C 

2- recNumber =1 // rec 1 


2 - Shall throw 






mode = REC_ACC_MODE_ABSOLUTE 


uicc . access . UICCException with 






recOffset = -1 
respOffset = 


reason code 
OUT_OF_RECORD_BOUNDARIES . 






respLength = 4 
readRecord () 






17 


recOffset + respLength > Record Length 

1- select EFlaro, fid=6F0C 








2- recNumber = 1 


2 - Shall throw 






mode = REC_ACC_M0DE_ABS0LUTE 
recOffset = 2 


sim. access . SIMViewException with 
reason code 






respOffset = 
respLength = 4 


OUT_OF_RECORD_BOUNDARIES . 






readRecord () 
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Id 


Description 


API Expectation 


APDU Expectation 


18 


Reading with invalid mode 








1- select EFlaro, fid=6F0C 

2- recNumber = 


2 - Shall throw 






mode = 1 


uicc . access . UICCException with 






recOffset = 
respOffset = 
respLength = 4 
readRecord () 
3- mode = 5 


reason code 
COMMAND_INCOMPATIBLE . 
3 - Shall throw uicc.access. 
UICCException with reason code 
COMMAND_INCOMPATIBLE . 






readRecord ( ) 






19 


resp is null 

resp[] = null 


Shall throw 






mode = REC_ACC_MODE_CURRENT 


Java. lang.NullPointerException. 






respOffset = 








respLength = 10 








readRecord ( ) 






20 


respOffset < 

respOffset = -1 
respLength = 10 


Shall throw 

Java. lang. ArraylndexOutOfBoundsE 






readRecord () 


xception. 




21 


respLength < 

respOffset = 
respLength = -1 
readRecord () 


Shall throw 
Java . lang . 
ArraylndexOutOfBoundsException . 




22 


respOffset + respLength > resp.length 

respOffset = 11 


Shall throw 






respLength = 4 
readRecord () 


Java . lang . 
ArraylndexOutOfBoundsException . 




23 


EF is neither Cyclic nor Linear Fixed 








1- select EFiNo, fid=6F02 

2- respOffset = 


2 - Shall throw 






respLength = 4 


uicc. access .UICCException with 






readRecord ( ) 


reason code 
COI«AND_INCOMPATIBLE . 




24 


Access condition not fulfilled 

1- select EFcNE, fid=6F04 


2 - Shall throw 






2 - respLength = 3 


uicc . access . UICCException with 






readRecord {) 


reason code 
SECURITY_STATUS_NOT_SATISFIED . 




25 


EF is deactivated 








1 - select EFcNu, fid=6F05 


2 - Shall throw uicc . access . UICC 






deactivateFile () 
2 - readRecord 


Exception with reason code 
REF_DATA_INVALIDATED 






3 - activateFile 







5.3.1 .1 1 Method updateRecord 

Test Area Reference: Api_4_Afv_Updr. 

5.3.1 .1 1.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void updateRecord (short recNumber, 

byte mode, 
short recOffset, 
byte [ ] data, 
short dataOffset, 
short dataLength) 
throws Java . lang . NullPointerException, 

Java .lang .ArraylndexOutOfBoundsException, 
UICCException 
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5.3.1.11.1.1 Normal execution 

• CRRN 1 : Reads a record or a part of record of the current linear fixed or cyclic EF into byte array data[] . 

• CRRN2: If the access mode is REC_ACC_MODE_ CURRENT the current selected record will be updated. 
The current record pointer shall not be changed. 

• CRRN3:If the access mode is REC_ACC_MODE_ ABSOLUTE and the file is Unear fixed EF, the record 
addresss by recNumber will be updated. The current record pointer shall not be changed. 

• CRRN4: If the access mode is REC_ACC_MODE_NEXT and the file is a linear fixed EF the next record 
relative to the current selected record will be selected and updated. The record pointer shall be updated. 

• CRRN5: If the access mode is REC_ACC_MODE_NEXT and the record pointer has not been previously set 
within the selected EF, the record pointer shall be set to the first record and this record should be updated. 

• CRRN6: If the access mode is REC_ACC_MODE_PREVIOUS the previous record relative to the current 
selected record will be selected and updated. The record pointer shall be updated. 

• CRRN7: If the access mode is REC_ACC_MODE_PREVIOUS and the record pointer has not been previously 
set within the selected EF, then the record pointer should be set to the last record in this EF. This record should 
be updated. 

• CRRN8: If the access mode is REC_ACC_MODE_PREVIOUS, the file is a cyclic EF, the oldest record will 
be updated independent of the current record pointer and this record becomes record number 1 and the current 
record. 

5.3.1.11.1.2 Parameter errors 

• CRRPl : If the currently selected EF is linear fixed and the access mode is REC_ACC_MODE_ABSOLUTE 
and recNumber is less than or greater than records available, an instance of UICCException shall be thrown. 
The reason code shall be UICCException.RECORD_NOT_FOUND. 

• CRRP2: If the currently selected EF is hnear fixed and the access mode is REC_ACC_MODE .CURRENT, 
recNumber is and there is no current record selected, an instance of UICCException shall be thrown. The 
reason code shall be UICCException. RECORD_NOT_FOUND. 

• CRRP3: If the currently selected EF is Unear fixed and the access mode is REC_ACC_MODE_NEXT and the 
current record pointer is set to the last record, an instance of UICCException shall be thrown. The reason code 
shall be UICCException. RECORD_NOT_FOUND. 

• CRRP4: If the currently selected EF is linear fixed and the access mode is REC_ACC_MODE_PREVIOUS 
and the current record pointer is set to the first record; an instance of UICCException shall be thrown. The 
reason code shall be UICCException. RECORD_NOT_FOUND. 

• CRRP5: If the specified offset into the selected record recOffset is less than 0, an instance of UICCException 
shall be thrown. The reason code shall be UICCException.OUT_OF_RECORD_BOUND ARIES. 

• CRRP6: If recOffset plus dataLength is greater than the record length, an instance of UICCException shall be 
thrown. The reason code shall be UICCException.OUT_OF_RECORD_BOUND ARIES. 

• CRRP7: If the access mode is not between 2 and 4 inclusive (2 = REC_ACC_MODE_NEXT, etc.), an 
instance of UICCException shall be thrown. The reason code shall be UICCException. IN VALID_MODE. 

• CRRP8: If the currently selected EF is cyclic and the mode of record access mode is not 
REC_ACC_MODE_PREVIOUS, an instance of UICCException shall be thrown. The reason code shall be 
UICCException.INVALID_MODE. 

• CRRP9: If the array data is null, an instance of NullPointerException shall be thrown. 

• CRRPIO: If dataOffset is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

• CRRPl 1 : If dataLength is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 
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• CRRP12: If dataOffset plus dataLength, is greater than the length of the array data.length, or dataOffset equals 
data.length, an instance of ArraylndexOutOfBoundsException shall be thrown. 



5.3.1.11.1.3 



Context errors 



CRRCl: If the calling applet has currently no EF selected, an instance of UICCException shall be thrown. The 
reason code shall be UICCException.NO_EF_SELECTED. 

CRRC2: If the currently selected EF is neither linear fixed nor cyclic, an instance of UICCException shall be 
thrown. The reason code shall be UICCException.COMMANDJNCOMPATIBLE. 

CRRC3: If the calling applet does not fulfil the access condition, UPDATE, to perform this function, an 
instance of UICCException shall be thrown. The reason code shall be UICCException. 
SECURITY_STATUS_NOT_SATISFIED. 

CRRC4: If the currently selected EF is deactivated and the file status of the EF does not allow for updating an 
deactivated file, an instance of UICCException shall be thrown. The reason code shall be UICCException. 
REF_DATA_INVALIDATED. 

CRRC5: If the method call causes a memory problem (e.g. memory access error), an instance of 
UICCException shall be thrown. The reason code shall be UICCException.MEMORY_PROBLEM. 

CRRC6: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
UICCException shall be thrown. The reason code shall be UICCException.INTERNAL_ERROR. 



5.3.1.11.2 

Test Source: 
Test Applet: 
Cap File: 



Test area files 

Test_Api_4_Afv_Updr.j ava. 
Api_4_Afv_ Updr_l.java. 
api_4_Afv_updr. cap . 



5.3.1.11.3 



Test coverage 



CRR number 


Test case number 


N1 


2,3,4,5,7,8,10 


N2 


2 


N3 


3 


N4 


5 


N5 


4 


N6 


7,8,9,10 


N7 


7 


N8 


10 


PI 


11 


P2 


12 


P3 


6 


P4 


9 


P5 


13 


P6 


14 


P7 


15 


P8 


16 


P9 


17 


RIO 


18 


P11 


19 


P12 


20 


CI 


1 


C2 


21 


C3 


22 


C4 


23 


C5 


Not testable 


C6 


Not testable 
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5.3.1.11.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Get the UICC AdminFileView 

AdminFileViewBuilder . getTheUICCAdminFil 
eView (CLEAR_ON_RESET) 






1 


No EF selected 

RecNumber = 1 

mode = REC_ACC_MODE_ABSOLUTE 

recOffset = 

byte[] data = new byte [20] 

dataOffset = 

dataLength = 10 

updateRecord ( ) 


Shall throw uicc.access.UICC Exception 
with reason code NO_EF_SELECTED. 




2 


Update Absolute from Linear Fixed EF 

1- select DFtesi, fid = 1111 

2- select EFibru, fid = 6F0C 
// Record pointer not set. 

3- recNumber = 2 

mode = REC_ACC_MODE_ABSOLUTE 

data [0:3] = '11' 

recOffset = 

dataOffset = 

dataLength = 4 

updateRecord 

respOffset = 

respLength = 

readRecord ( ) 

4- // verify result 
read respOffset = 
respLength = 4 
recNumber = 

mode = REC_ACC_MODE_CURRENT 
readRecord ( ) 


1- No exception shall be thrown. 

2- No exception shall be thrown. 

3- No exception shall be thrown. 
4- Resp shall be: 1 1 111111 




3 


Update Current from Linear Fixed EF 

1- select DFtesi, fid = 1111 

2- select EFiiRo, fid = 6F0C 

// Set record pointer with mode "next". 

3- recNumber = 

mode = REC_ACC_MODE_NEXT 

recOffset = 

data [0:3] = '00' 

dataOffset = 

dataLength = 4 

updateRecord ( ) 

// write data with mode "current" 

4- recNumber = 
data[0:3] = '22' 

mode = REC_ACC_MODECURRENT 
updateRecord ( ) 

5- //verify result 
respOffset = 
respLength = 4 
recNumber = 

mode = REC_ACC_MODE_ CURRENT 
readRecord ( ) 


1- No exception shall be thrown. 

2- No exception shall be thrown. 

3- No exception shall be thrown. 

5- No exception shall be thrown. 

resp shall be: 

resp[0] = '22' 

resp[1] = '22' 

resp[2] = '22' 

resp[3] = '22' 




4 


Update Next from Linear Fixed EF, no 
record pointer set 

1- select DFtesi, fid = 1111 

2- select EFiaro, fid = 6F0C 

3- recNumber = 

mode = REC_ACC_MODE_NEXT 

recOffset = 

data[0:3] = '33' 

dataOffset = respOffset = 

dataLength = respLength = 4 

updateRecord ( ) 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 

4-// verify result 

readRecord ( ) 


1- No exception shall be thrown. 

2- No exception shall be thrown. 

4- No exception shall be thrown. 

resp shall be: 

resp[0] = '33' 

resp[1] = '33' 

resp[2] = '33' 

resp[3] = '33' 
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5 


Update Next from Linear Fixed EF, record 








pointer set 


1 - No exception shall be thrown. 






1- recNumber = 








mode = REC_ACC_MODE_NEXT 








recOffset = 








data[0:3] = '44' 
dataOffset = 


2- No exception shall be thrown. 






dataLength = 4 


rasp shall be: 






updateRecord ( ) 


resp[0] = '44' 






2- //verify result 


resp[1] = '44' 






readRecord ( ) 


resp[2] = '44' 
resp[3] = '44' 




6 


Update Next from Linear Fixed EF, no more 
records 








recNumber = 


Shall throw uicc.access.UICCException 






mode = REC„ACC_MODE_NEXT 


with reason code 






recOffset = 


RECORD_NOT_FOUND. 






data[0:3] = '55' 








dataOffset = 








dataLength = 4 








updateRecord ( ) 






7 


Update Previous from Linear Fixed EF, no 
record pointer set 








1- select DFtesi, fid = 1111 


1- No exception shall be thrown. 






2- select EFuro, fid = 6F0C 


2- No exception shall be thrown. 






3- recNumber = 


3- No exception shall be thrown. 






mode = REC_ACC_MODE_PREVIOUS 








recOffset = 








data[0:3] = '66' 








dataOffset = respOffset = 








dataLength = respLength = 4 


4- No exception shall be thrown. 






updateRecord ( ) 


resp shall be: 






4- //verify result 


resp[0] = '66' 






readRecord ( ) 


resp[1] = '66' 
resp[2] = '66' 
resp[3] = '66' 




8 


Update Previous from Linear Fixed EF, 
record pointer set 








1- recNumber = 


1 - No exception shall be thrown 






mode = REC_ACC_MODE„PREVIOUS 








recOffset = 
data[0:3] = '77' 
dataOffset = respOffset = 


2- No exception shall be thrown, 
esp shall be: 






dataLength = respLength = 4 


resp[0] = '77' 






updateRecord ( ) 


resp[1] = '77' 






2- //verify result 


resp[2] = '77' 






readRecord ( ) 


resp[3] = '77' 




9 


Update Previous from Linear Fixed EF , no 
more records 








recNumber = 


Shall throw 






mode = REC_ACC_MODE_PREVIOUS 


sim. access. SIIVIViewException with 






recOffset = 


reason code RECORD_NOT_FOUND. 






data [0:3] = '88' 








dataOffset = respOffset = 








dataLength = respLength = 4 
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10 


Update Previous from Cyclic EF 

1- select DFtest, fid = 1111 

2- select EFcaru, fid = 6F09 

3- recNumber = 2 

mode = REC_ACC_MODE_ABSOLUTE 
recOffset = 
respOffset = 
respLength = 3 
readRecord ( ) 

4- recNumber = 2 

mode = REC_ACC_MODE_PREVIOUS 
data [0:2] = 'FF' 
dataOffset = 
dataLength = 3 
updateRecord ( ) 

5- //verify result 
readRecord ( ) 


1- No exception shall be thrown. 

2- No exception shall be thrown. 

3- No exception shall be thrown. 

4- No exception shall be thrown. 

5- No exception shall be thrown, 
resp shall be: 

resp[0] = 'FF'resp[1] = 'FF' 
resp[2] = 'FF' 




11 


Update Absolute from Linear Fixed EF 
beyond Records 

1- select EFiiEo, fid = 6F0C 

2-recNumber = -1 

mode = REC_ACC_MODE_ABSOLUTE 

recOffset = 

dataOffset = 

dataLength = 4 

updateRecord ( ) 

3- recNumber = 3 

updateRecord ( ) 


1- No exception shall be thrown. 

2- Shall throw 

uicc.access.UICCException with reason 
code RECORD_NOT_FOUND. 

3- Shall throw 

uicc.access.UICCException with reason 
code RECORD_NOT_FOUND. 




12 


No current record in linear fixed EF, update 
current 

1- select EFisEo, fid = 6F0C 
// No curr rec 

2- recNumber =0 // curr rec 
mode = REC_ACC_MODE _CURRENT 
recOffset = 

dataOffset = 
dataLength = 4 
updateRecord () 


1 - No exception shall be thrown. 

2 - Shall throw 

uicc.access.UICCException with reason 
code RECORD_NOT_FOUND. 




13 


recOffset < 

1- select EFisEo, fid = 6F0C 

2- recNumber =1 // rec 1 
mode = REC_ACC_MODE_ABSOLUTE 
dataOffset = 
dataLength = 4 
updateRecord ( ) 


1- No exception shall be thrown. 

2- Shall throw uicc.access.UICC 
Exception with reason code 
OUT_OF_RECORD_BOUNDARIES. 




14 


recOffset + dataLength > record.length 

1- select EFiiEo, fid = 6F0C 

2- recNumber = 1 

mode = REC_ACC_MODE_ABSOLUTE 
recOffset = 2 
dataOffset = 
dataLength = 4 
updateRecord ( ) 


1- No exception shall be thrown. 

2- Shall throw uicc.access.UICC 
Exception with reason code 
OUT_OF_RECORD_BOUNDARIES. 




15 


Updating with invalid mode 

1- select EFlaru, fid = 6F0C 

2- recNumber = 
mode = 1 
recOffset = 
dataOffset = 
dataLength = 4 
updateRecord ( ) 

3- mode = 5 
updateRecord ( ) 


1 - No exception shall be thrown. 

2 - Shall throw uicc.access.UICC 
Exception with reason code 
INVALID_MODE. 

3 - Shall throw uicc.access. UICC 
Exception with reason code 
INVALID MODE. 
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16 


Updating Cyclic EF with invalid mode 

1- select DFtesi, fid = 1111 

2- select EFcaru, fid = 6F09 

set record pointer to record nr 1 

3- recNumber = 

mode = REC_ACC_MODE_NEXT 
recOffset = 
data[0:2] = '00' 
dataOffset = 
dataLength = 3 
updateRecord ( ) 

4- recNumber = 

mode = REC_ACC_MODE_ABSOLUTE 
updateRecord ( ) 

5- recNumber = 2 

mode = REC_ACC_MODE_ABSOLUTE 
updateRecord ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - Shall throw uicc.access. UlCC 
Exception with reason code 
INVALID_MODE. 

4 - Shall throw uicc.access. UlCC 
Exception with reason code 
INVAL1D_M0DE. 

5 - Shall throw uicc.access. UlCC 
Exception with reason code 
INVALID MODE. 




17 


data[] is null 

data[] = null 
dataOffset = 
dataLength = 10 
updateRecord () 


Shall throw 
java.lang.NullPointerException. 




18 


dataOffset < 

dataOffset = -1 
dataLength = 10 
updateRecord ( ) 


Shall throw 

java.lang. 

Array IndexOutOfBoundsException. 




19 


dataLength < 

dataOffset = 
dataLength = -1 
updateRecord ( ) 


Shall throw 

java.lang. 

Array IndexOutOfBoundsException. 




20 


dataOffset + dataLength > data.length 

dataOffset = 10 
dataLength =11 
updateRecord 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsException. 




21 


EF is neither Cyclic nor Linear Fixed 

1- select DFtesi, fid = 1111 

2- select EFtaru, fid = 6F03 

3- dataOffset = 
dataLength = 4 
updateRecord 


1- No exception shall be thrown. 

2- No exception shall be thrown. 

3- Shall throw uii. access. UlCC 
Exception with reason code 
COMMAND INCOMPATIBLE. 




22 


Access condition not fulfilled 

1- select EFcNo, fid = 6F05 

2- recOffset = 
dataOffset = 
dataLength = 1 

mode = REC_ACC_MODE_PREVIOUS 
updateRecord () 

3- fid = EFLNU 
select 

4- recNumber = 1 

mode = REC_ACC_MODE_ CURRENT 
recOffset = 
dataOffset = 
dataLength = 1 
updateRecord 


1- No exception shall be thrown. 

2- Shall throw uicc.access. UlCC 
Exception with reason code 
SECURITY STATUS NOT SATISFIE 
D. 

3- No exception shall be thrown. 

4- Shall throw uicc.access. UlCC 
Exception with reason code 
SECURITY STATUS NOT SATISFIE 
D 




23 


EF is deactivated 

1- select EFcNR, fid = 6F04 
invalidate ( ) 

2- updateRecord ( ) 

3- activateFile 

4- restore the file content EFlaru, EFcaru 

Restore the file content 

1- restore the file content of EFlaru^ 
record 1 = 0x55,0x55,0x55,0x55 
record 2 = OxAA, OxAA, OxAA, OxAA 

2- restore the file content of EFcaru: 
record 1 = 0x55,0x55,0x55 

record 2 = OxAA, OxAA, OxAA 


1- No exception shall be thrown. 

2- Shall throw 

uicc.access.UICCException with reason 
codeREF_DATA_INVALIDATED 

3- No exception shall be thrown. 
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5.3.1.12 Method search Record 

Test Area Reference: Api_4_Afv_Sear. 

5.3.1.12.1 Conformance requirement 

The method with following header shall be compliant to its definition in the APT 

public short searchRecord (byte mode, 

short recordNum, 
short searchlndication, 
byte[] patt, 
short pattOffset, 
short pattLength, 
short [] response, 
short respOffset, 
short respLength) 
throws Java . lang. NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
UICCException 

5.3.1.12.1.1 Normal execution 

• CRRNl : Search a given pattern in byte array patt[] of a current linear fixed or cyclic EF. 

• CRRN2: If the pattern is found, the number of each record is stored in byte array response[] and the total 
number of updated bytes in the array response [] buffer is returned. 

• CRRN3: If the value of respLength is greater than the number of records found, the whole response is copied 
into the response buffer and the number of elements copied is returned by the method. 

• CRRN4: If the value of respLength is smaller than the number of found patterns, the first record numbers are 
copied into the response array and the value of respLength is returned. 

• CRRN5: If mode is SIMPLE_SEARCH_START_FORWARD, the search starts at the given record number 
forward towards the end of the file. 

• CRRN6: If mode is SIMPLE_SEARCH _START_BACKWARD, the search starts at a given record number 
backward towards to the beginning of the file. 

• CRRN7: If mode is ENHANCED_SEARCH and 
SEARCH_INDICATION_START_BACKWARD_FROM_PREVIOUS is set in searchlndication, the search 
is backward starting from previous record towards to the beginning of the file. 

• CRRN8 : If the mode is ENHANCED_SEARCH and 
SEARCH_INDICATION_START_BACKWARD_FROM_PREVIOUS_GR is set in searchlndication, the 
search is backward starting at a given record from previous record towards to the beginning of the file. 

• CRRN9: If the mode is ENHANCED_SEARCH and 
SEARCH_INDICATION_START_FORWARD_FROM_NEXT is set in searchlndication, the search is 
forward starting at the next record towards the end of the file. 

• CRRN 1 0: If the mode is ENHANCED_SEARCH and 
SEARCH_INDICATION_FORWARD_FROM_NEXT_GR is set in searchlndication, the search is forward 
starting at a given record number towards to the end of the file. 

• CRRN 11 : If the mode is ENHANCED_SEARCH, and bit 4 of the most significant byte of the 
searchlndication is not set, the search starts in the record from the offset (absolute position) given in the less 
significant byte of searchlndication. 

• CRRN12: If the mode is ENHANCED_SEARCH, and bit 4 of the most significant byte of the 
searchlndication is set, the search starts in the record after the first occurrence of the value contained in the less 
significant byte of searchlndication. 

• CRRN 13: If pattern given in patt[] is not found, the method returns 0. 
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• CRRN14: If one or more matches are found the record pointer shall be set to the first record where the search 
pattern was found. 

5.3.1.12.1.2 Parameter errors 

• CRRPl : If mode is not 4, 5 or 6, an instance of UICCException shall be thrown. The reason code shall be 
UICCException.INVALID_MODE. 

• CRRP2: If the pattern array patt is null, an instance of java.lang.NuUPointerException shall be thrown. 

• CRRP3: If the response array response is null, an instance of java.lang.NullPointerExceptino shall be thrown. 

• CRRP4: If parameter pattOffset is negative, an instance of java.lang.ArraylndexOutOfBoundsException shall 
be thrown. 

• CRRP5: If parameter pattLength is negative, an instance of java.lang.ArraylndexOutOfBoundsException shall 
be thrown. 

• CRRP6: If parameter respOffset is negative, an instance of java.lang.ArraylndexOutOfBoundsException shall 
be thrown. 

• CRRP7: If parameter respLength negative, an instance of java.lang.ArraylndexOutOfBoundsException shall 
be thrown. 

• CRRP8: If parameter pattOffset plus pattLength are greater than the length of array patt, an instance of 
java.lang.ArraylndexOutOfBoundsException shall be thrown. 

• CRRP9: If parameter respOffset plus respLength are greater than the length of array response a 
ArraylndexOutOfBoundsException shall be thrown. 

• CRRPIO: If parameter recordNum is negative, an instance of UICCException shall be thrown. The reason 
code shall be UICCException.RECORD_NOT_FOUND. 

• CRRPl 1: If parameter recordNum is greather than, the total number of records from the currently selected EF, 
an instance of UICCException shall be thrown. The reason code shall be 
UICCException.RECORD_NOT_FOUND. 

• CRRPl 2 If pattLength is greater than record size of the currently selected EF an instance of UICCException 
shall be thrown. The reason code shall be UICCException.OUT_OF_FILE_BOUND ARIES. 

5.3.1.12.1.3 Context errors 

• CRRCl : If the calling applet has currently no EF selected, an instance of UICCException shall be thrown. The 
reason code shall be UICCException.NO_EF_SELECTED. 

• CRRC2: If the currently selected EF is not linear fixed or cyclic, an instance of UICCException shall be 
thrown. The reason code shall be UICCException.COMMAND_INCOMPATIBLE. 

• CRRC3: If the calling applet does not fulfil the access condition, READ, to perform this function, an instance 
of UICCException shall be thrown. The reason code shall be 
UICCException.SECURITY_STATUS_NOT_SATISFIED. 

• CRRC4: If the currently selected EF is deactivated and the file status of the EF does not allow for reading a 
deactivated file, an instance of UICCException shall be thrown. The reason code shall be 
UICCException.REF_DATA_INVALIDATED. 

• CRRC5: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
UICCException shall be thrown. The reason code shall be UICCException.INTERNAL_ERROR. 

5.3.1.12.2 Test area files 

Test Source: Test_Api_4_Afv_Sear.java. 
Test Applet: Api_4_Afv_Sear_Ljava. 
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Cap File: 
5.3.1.12.3 



Api_4_Afv_sear. cap . 



Test coverage 



5.3.1.12.4 



CRR number 


Test case number 


N1 


2, 3, 4, 5, 6, 7, 8, 9, 1 0, 1 1 , 28, 29, 30, 31 , 32, 


33, 34, 35, 36, 37 


N2 


2, 3, 4, 5, 6, 7, 8, 9, 1 0, 1 1 , 28, 29, 30, 31 , 32, 


33, 34, 35, 36, 37 


N3 


2, 3, 4, 5, 6, 7, 8, 9, 1 0, 1 1 , 28, 29, 30, 31 , 32, 


33, 34, 35, 36, 37 


N4 


12 


N5 


2,28 


N6 


3,29 


N7 


6, 7, 34, 35 


N8 


8, 9, 36, 37 


N9 


10, 11,30,31 


N10 


12, 13,32,33 


N11 


6,8, 10, 12,30, 32,34, 36 


N12 


7, 9, 11, 13,31,33,35,37 


N13 


2, 3, 5,7,9, 11,28, 31 


N14 


6,7, 10, 11,30,31,34,35 


P1 


13 


P2 


14 


P3 


15 


P4 


16 


P5 


17 


P6 


18 


P7 


19 


P8 


20 


P9 


21 


P10 


22 


P11 


23 


P12 


24 


C1 


1 


C2 


25 


C3 


26 


C4 


27 


C5 


Not testable 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


No EF selected 

1- select DFiEST, fid=llll 

2- searchRecord 


2-shall throw uicc. access. UICC 
Exception with reason code 
NO EF SELECTED. 
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Id 


Description 


API Expectation 


APDU Expectation 


2 


Fixed linear EF, 
Simple mode search forward 

1- select EFlsea, fid=6FlA 

2- mode = SIMPLE_SEARCH_START„FORWARD 
recordNum = 1 

patt []={OxlO, 0x03, 0x04} 
pattOffset = 
pattLength = 1 
response!] = {0,0,0,0} 
respOffset = 
respLength = 4 
searchRecord () 

3- Simple mode search forward 
mode = SIMPLE_SEARCH_START_FORWARD 
recordNum = 2 

patt []={OxlO, 0x03, 0x04} 
pattOffset = 1 
pattLength = 2 
resp. length = 4 
respOffset = 1 
respLength = 3 
searchRecord ( ) 


2- no exception shall be thrown 
Shall return 0. 

response shall be: 
response={0, 0,0,0} 

3- Shall return 2. 
response shall be: 
response={0, 2,4,0} 




3 


Simple mode, search backward 

1- mode = SIMPLE_SEARCH_START_BACKWARD 

recordNum = 1 

patt [] = {0x08, OxOA, OxOB} 

pattOffset = 

pattLength = 3 

response!] = {0,0,0,0} 

respOffset = 2 

respLength = 2 

searchRecord () 

2-mode = SIMPLE_SEARCH_START_BACKWARD 

recordNum = 6 

patt !] ={0x08, 0x09, OxOA, OxOB } 

pattOffset = 1 

pattLength = 2 

response!] = {0,0,0,0} 

respOffset = 1 

respLength = 3 

searchRecord {) 


1- shall return 0. 
response shall be: 
response={0, 0,0,0} 

2- shall return 3. 
response shall be: 
response={0,4,3,1} 




4 


Enhanced Mode, search backward from 

previous record, start from an offset in 

record. 

1- mode = ENHANCED_SEARCH 
searchIndication= 

SEARCH_INDICATION_BACKWARD_FROM„PREVIOUS 
+ 0x0009 

recordNum = 

patt ! ]={ 0x01, 0x02, 0x03, 0x04} 

pattOffset = 

pattLength = 3 

response!] = {0,0,0,0} 

respOffset = 

respLength = 4 

searchRecord () 

2- mode = ENHANCED_SEARCH 
sear chlndi cat ion= 

SEARCH_INDICATION_BACKWARD_FROM_PREVIOUS 
-^OxOOOO 

recordNum = 

patt !]={OxOC, OxOD, OxOE, OxOF, 0x01, 0x02} 

pattOffset = 

pattLength = 5 

response!] = {0,0,0,0} 

respOffset = 2 

respLength = 2 

searchRecord ( ) 


1- shall return 1, 
response shall be: 
resp={3, 0,0,0} 

2- shall return 1 
response shall be: 
response={0, 0,2,0} 
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Id 


Description 


API Expectation 


APDU Expectation 


5 


Enhanced Mode, search backward from 
previous record, start from a value in record. 

1- mode = ENHANCED_SEARCH 
sear chlndi cat ion= 

SEARCH_IND I CAT I ON_BACKWARD_FROM_PREVI OUS 

+ 0x0810 

recordNum = 

patt []={0x01, 0x02, 0x03, 0x04} 

pattOffset = 

pattLength = 3 

response!] = {0,0,0,0} 

respOffset = 

respLength = 4 

searchRecord ( ) 

2- perform 3 readRecordO in next mode 
to set current pointer to pointer 5 

3- mode = ENHANCED_SEARCH 
sear chlndi cat ion= 

SEARCH_INDICATION_BACKWARD_FROM_PREVIOUS 
+0x080E 

recordNum = 

patt []={ 0x01, 0x02, 0x03, 0x04} 

pattOffset = 3 

pattLength = 1 

response!] = {0,0,0,0} 

respOffset = 

respLength = 4 

searchRecord {) 


1- shall return 0, 
response shall be: 
resp={0, 0,0,0} 

3- shall return 2 
response shall be: 
response={4,2,0,0} 




6 


Enhanced Mode, search backward from 

previous given record, start from an offset in 

record. 

1- mode = ENHANCED_SEARCH 
sear chlndi cat ion= 

SEARCH_INDICATION_BACKWARD_FROM_PREVIOUS 
_GR + 0x0000 

recordNum = 1 
patt !]={0x01, 0x02, 0x03} 
pattOffset = 
pattLength = 1 
response!] = {0,0,0,0} 
respOffset = 
respLength = 4 
searchRecord () 

2- mode = ENHANCED_SEARCH 
sear chlndi cat ion= 

SEARCH_1NDICATI0N_BACKWARD_FR0M_PREVI0US 
_GR + 0x0004 

recordNum = 6 
patt !] = { 0x01, 0x02, 0x03} 
pattOffset = 
pattLength = 3 
response!] = {0,0,0,0} 
respOffset = 
respLength = 4 
searchRecord ( ) 


1- shall return 1, 
response shall be: 
resp={1, 0,0,0} 

2- shall return 4 
response shall be: 
response={5,4,3,2} 
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Id 


Description 


API Expectation 


APDU Expectation 


7 


Enhanced Mode, search backward from 

previous given record, start from a value in 

record. 

1- mode = ENHANCED_SEARCH 
searchIndication= 

SEARCH_INDICATION_BACKWARD_FROM_PREVIOUS 
_GR + OxOBOD 

recordNum = 1 
patt []={OxOE, OxOE, OxOE} 
pattOffset = 1 
pattLength = 1 
response!] = {0,0,0,0} 
respOffset = 
respLength = 4 
searchRecord () 

2- mode = ENHANCED_SEARCH 
sear chlndi cat ion= 

SEARCH„INDICATION„BACKWARD_FROM_PREVIOUS 
_GR + 0x0800 

recordNum = 6 
patt !] = {0x01, 0x02, 0x03} 
pattOffset = 
pattLength = 3 
response!] = {0,0,0,0} 
respOffset = 
respLength = 4 
searchRecord ( ) 


1- shall return 1, 
response shall be: 
resp={1, 0,0,0} 

2- shall return 
response shall be: 
response={0, 0,0,0} 




8 


Enhanced Mode, search forward from next 
record, start from an offset in record. 

1- mode = ENHANCED_SEARCH 
sear chlndi cat ion= 

SEARCH_INDICATION_FORWARD_FROM_NEXT + 
0x0003 

recordNum = 
patt !]={OxOO, OxOA, OxOB} 
pattOffset = 1 
pattLength = 2 
response!] = {0,0,0} 
respOffset = 2 
respLength = 2 
searchRecord ( ) 

2- Perform readRecordO in previous mode 

3- mode = ENHANCED_SEARCH 
sear chlndi cat ion= 

SEARCH_INDICATION_FORWARD_FROM_NEXT + 
0x0003 

recordNum = 
patt !] ={0x00, OxOA, OxOB} 
pattOffset = 1 
pattLength = 2 
response!] = {0,0,0,0} 
respOffset = 
respLength = 4 
searchRecord {) 


1- shall return 2 
response shall be: 
resp={0,0,3,4} 

3- shall return 1 
response shall be: 
response={4, 0,0,0} 





ETSI 



Release 6 



488 



ETSI TS 102 268 V6.0.0 (2007-03) 



Id 


Description 


API Expectation 


APDU Expectation 


9 


Enhanced IVIode, search forward from next 
record, start from a value in record. 

1- mode = ENHANCED_SEARCH 
sear chlndi cat ion= 

SEARCH_IND I CAT I ON_FORWARD_FROM_NEXT + 

0x0804 

recordNum = 

patt []={0x01, 0x02, 0x03} 

pattOffset = 1 

pattLength = 2 

response[] = {0,0,0,0} 

respOffset = 2 

respLength = 2 

searchRecord ( ) 

2- mode = ENHANCED_SEARCH 
searchIndication= 

SEARCH_IND I CAT I ON_FORWARD_FROM_NEXT + 

0x0801 

recordNum = 

patt []={0x01, 0x02, 0x03} 

pattOffset = 2 

pattLength = 1 

response[] = {0,0,0,0} 

respOffset = 

respLength = 4 

searchRecord () 


1- shall return 0, 
response shall be: 
resp={0, 0,0,0} 

2- shall return 2 
response shall be: 
response={5, 6,0,0} 




10 


Enhanced Mode, search forward from next 
given record, start from an offset in record. 

1- mode = ENHANCED_SEARCH 
sear chlndi cat ion= 

SEARCH_IND I CAT I ON_FORWARD_FROM_NEXT_GR + 

0x0007 

recordNum = 1 

patt []={0x01, 0x02, 0x03} 

pattOffset = 

pattLength = 3 

response[] = {0,0,0,0} 

respOffset = 1 

respLength = 3 

searchRecord () 

2- mode = ENHANCED_SEARCH 
searchIndication= 

SEARCH_IND I CAT I ON_FORWARD_FROM_NEXT_GR + 

OxOOOC 

recordNum = 3 

patt []={0x03, 0x02, 0x01} 

pattOffset = 

pattLength = 3 

response!] = {0,0,0,0} 

respOffset = 

respLength = 4 

searchRecord ( ) 


1- shall return 3, 
response shall be: 
resp={0, 3,4,5} 

2- shall return 1 
response shall be: 
response={6, 0,0,0} 
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Id 


Description 


API Expectation 


APDU Expectation 


11 


Enhanced Mode, search forward from next 
given record, start from a value in record. 

1- mode = ENHANCED_SEARCH 
sear chlndi cat ion= 

SEARCH_IND I CAT I ON_FORWARD_FROM_NEXT_GR + 

OxOSOD 

recordNum = 5 

patt []={0x01, 0x02, 0x03} 

pattOffset = 

pattLength = 3 

response!] = {0,0,0,0} 

respOffset = 

respLength = 4 

searchRecord ( ) 

2- mode = ENHANCED_SEARCH 
searchIndication= 

SEARCH_IND I CAT I ON_FORWARD_FROM_NEXT_GR + 

0x080c 

recordNum = 5 

patt !]={0x01, 0x02, 0x03} 

pattOffset = 

pattLength = 3 

response!] = {0,0,0,0} 

respOffset = 

respLength = 4 

searchRecord {) 


1- shall return 0, 
response shall be: 
resp={0, 0,0,0} 

2- shall return 1 
response shall be: 
response={5, 0,0,0} 




12 


Simple mode, total number of found patterns 
exceed response[] 

1- mode = SIMPLE_SEARCH_START_FORWARD 
recordNum = 1 

patt !]={0x01, 0x02, 0x03} 
pattOffset = 
pattLength = 3 
response!] = {0,0,0,0} 
respOffset = 
respLength = 4 
searchRecord () 

2- mode = SIMPLE_SEARCH_START_FORWARD 
recordNum = 1 

patt !] = { 0x01, 0x02, 0x03} 
pattOffset = 
pattLength = 3 
response!] = {0,0,0,0,0} 
respOffset = 
respLength = 4 
searchRecord () 


1- shall return 4 
response shall be: 
response={1,2,3,4} 

2- shall return 4 
response shall be: 
response={1,2,3,4,0} 




13 


Invalid mode 

mode = 0x14 (simple search forward with 

SFI) 

searchIndication= 

recordNum = 2 

patt !]={0x01, 0x02, 0x03} 

pattOffset = 1 

pattLength = 2 

response!] = {0,0,0,0,0} 

respOffset = 2 

respLength = 2 

searchRecord {) 


shall throw an uicc.access.UICC 
Exception with reason code 
INVALID_MODE. 




14 


Pattern array is null 

mode = SIMPLE_SEARCH_START_FORWARD 

searchIndication= 

recordNum = 

patt !]= null 

pattOffset = 1 

pattLength = 2 

response!] = {0,0,0,0,0} 

respOffset = 2 

respLength = 2 

searchRecord ( ) 


shall throw an 
java.lang.NullPointerException. 
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Id 


Description 


API Expectation 


APDU Expectation 


15 


Response array is null 

mode = SIMPLE_SEARCH_START_FORWARD 

searchIndication= 

recordNum = 

patt []={0x01, 0x02, 0x03} 

pattOffset = 

pattLength = 1 

response!] = null 

respOffset = 

respLength = 5 

searchRecord ( ) 


shall throw an instance of 
java.lang.NullPointerException. 




16 


pattOffset<0 

mode = SIMPLE_SEARCH_START_FORWARD 

searchIndication= 

recordNum = 

patt !] = { 0x01, 0x02, 0x03} 

pattOffset = -1 

pattLength = 1 

response!] = {0,0,0,0,0} 

respOffset = 

respLength = 5 

searchRecord () 


shall throw an instance of 

java.lang.ArraylndexOutOfBoundsExc 

eption. 




17 


pattLength<0 

mode = SIMPLE_SEARCH_START_FORWARD 

searchIndication= 

recordNum = 

patt !] = {0x01, 0x02, 0x03} 

pattOffset = 

pattLength = -1 

response!] = {0,0,0,0,0} 

respOffset = 

respLength = 5 

searchRecord () 


shall throw an instance of 

java.lang.ArraylndexOutOfBoundsExc 

eption. 




18 


respOffset <0 

mode = SIMPLE_SEARCH_START_FORWARD 

searchIndication= 

recordNum = 

patt!]={0x01, 0x02, 0x03} 

pattOffset = 

pattLength = 1 

response!] = {0,0,0,0,0} 

respOffset = -1 

respLength = 5 

searchRecord {) 


shall throw an instance of 

java.lang.ArraylndexOutOfBoundsExc 

eption. 




29 


respLength <0 

mode = SIMPLE_SEARCH_START_FORWARD 

searchIndication= 

recordNum = 

patt !]={0x01, 0x02, 0x03} 

pattOffset = 

pattLength = 1 

response!] = {0,0,0,0,0} 

respOffset = 

respLength = -1 

searchRecord ( ) 


shall throw an Instance of 

java.lang.ArraylndexOutOfBoundsExc 

eption. 




20 


PattOffset + pattLength > patt[] 

mode = SIMPLE_SEARCH_START_FORWARD 

searchIndication= 

recordNum = 

patt !]={ 0x01, 0x02, 0x03} 

pattOffset = 2 

pattLength = 2 

response!] = {0,0,0,0,0} 

respOffset = 1 

respLength = 5 

searchRecord ( ) 


shall throw an instance of 

java.lang.ArraylndexOutOfBoundsExc 

eption. 
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Id 


Description 


API Expectation 


APDU Expectation 


21 


RespOffset + respLength > response[] 

mode = SIMPLE_SEARCH_START_FORWARD 

searchIndication= 

recordNum = 

patt !]={0x01, 0x02, 0x03} 

pattOffset = 

pattLength = 1 

response!] = {0,0,0,0,0} 

respOffset = 3 

respLength = 3 

searchRecord ( ) 


shall throw an instance of 

java.lang.ArraylndexOutOfBoundsExc 

eption. 




22 


recordNum < 

mode = SIMPLE_SEARCH_START_FORWARD 

searchIndication= 

recordNum = -1 

patt !]={0x01, 0x02, 0x03} 

pattOffset = 

pattLength = 1 

response!] = {0,0,0,0,0} 

respOffset = 

respLength = 5 

searchRecord ( ) 


shall throw an uicc.access.UICC 
Exception with reason code 
RECORD_NOT_FOUND 




23 


RecordNum > total number of file records 

1- mode = SIMPLE_SEARCH_START_FORWARD 
searchIndication= 

recordNum = 7 
patt !] = {0x01, 0x02, 0x03} 
pattOffset = 
pattLength = 1 
response!] = {0,0,0,0,0} 
respOffset = 
respLength = 5 
searchRecord () 

2- mode = SIMPLE_SEARCH_START_FORWARD 
searchIndication= 

recordNum = 
patt !] = {0x01, 0x02, 0x03} 
pattOffset = 
pattLength = 1 
response!] = {0,0,0,0,0} 
respOffset = 
respLength = 5 
searchRecord ( ) 


1- shall throw an uicc.access.UICC 
Exception with reason code 
RECORD_NOT_FOUND 

2- shall throw an uicc.access.UICC 
Exception with reason code 
RECORD_NOT_FOUND 




24 


pattlength > record length 

1- mode = SIMPLE_SEARCH_START_FORWARD 
searchIndication= 

recordNum = 3 

patt !16] = {0x5 5, 0x5 5,..., 0x5 5} 
pattOffset = 
pattLength =16 
response!] = {0,0,0,0,0} 
respOffset = 
respLength = 5 
searchRecord () 

2- mode = ENHANCED_SEARCH 
searchIndication= 

SEARCH_IND I CAT I ON_FORWARD_FROM_NEXT_GR + 

OxOOOE 

recordNum = 3 

patt !] = {0x01, 0x02, 0x03} 

pattOffset = 

pattLength = 3 

response!] = {0,0,0,0,0} 

respOffset = 

respLength = 5 

searchRecord ( ) 


1- shall throw an 

uicc. access. UlCCException with 
reason code 
OUT_OF_FILE_BOUNDARIES. 

2- shall throw an 

uicc. access. UlCCException with 
reason code 
OUT_OF_FILE_BOUNDARIES. 
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Id 


Description 


API Expectation 


APDU Expectation 


25 


Wrong file structure 

1- select EFtdac, fid=6F0F 








2- searchRecord ( ) 


2- shall throw an 

uicc. access. UlCCException with 

reason code 

COMMAND INCOMPATIBLE 




26 


Security status not satisfied 

1- select EFlnr, fid=6F0A 








2- searchRecord 


2- shall throw an 

uicc. access. UlCCException with 

reason code 

SECURITY STATUS NOT SATISFI 

ED 




27 


File deactivated 

1- select EFlsro, fid=6F10 

2- deactivateFile EFlaro 








3- searchRecord ( ) 

4- activateFile {) 


3- shall throw an 

uicc. access. UlCCException with 

reason code DATA INVALIDATED 




28 


Cyclic EF, Simple mode search forward 

1- select EFcsEA, fid=6FlB 








2- mode = SIMPLE_SEARCH_START_FORWARD 

recordNum = 1 

patt []={OxlO, 0x03, 0x04} 

pattOffset = 


2- shall return 
response shall be: 
response={0,0,0,0,0} 






pattLength = 1 








response[] = {0,0,0,0,0} 








respOffset = 








respLength = 5 








searchRecord () 








3- mode = SIMPLE_SEARCH_START_FORWARD 








recordNum = 2 








patt [} = {OxlO, 0x03, 0x04} 
pattOffset = 1 


3- Shall return 3. 






pattLength = 2 


response shall be: 






response}] = {0,0,0,0,0} 
respOffset = 2 


response={0,0,2,4,1} 






respLength = 3 








searchRecord () 








4- updateRecord ( ) in previous mode with 








value 








{0x03, 0x02, 0x01, 0x03,0x02, 0x01, 0x03, 0x02 








, 0x01, 0x03, 0x02, 0x01, 0x03, 0x02, 0x01} 








(new record 1 is set to previous record 

6) 

5- mode = SIMPLE_SEARCH_START_FORWARD 














recordNum = 2 








patt []={OxlO, 0x03, 0x04} 








pattOffset = 1 
pattLength = 2 


5- Shall return 3. 






response[] = {0,0,0,0,0} 


response shall be: 






respOffset = 2 
respLength = 3 


response={0,0,2,3,5} 






searchRecord () 






29 


Cyclic EF, Simple mode search backward 








mode = SIMPLE_SEARCH_START_BACKWARD 


shall return 3 






recordNum = 3 

patt []={OxlO, 0x03, 0x04} 

pattOffset = 1 


response shall be: 
response={0,3,2,5,0} 






pattLength = 2 








response!] = {0,0,0,0,0} 








respOffset = 1 








respLength = 4 








searchRecord () 
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Id 


Description 


API Expectation 


APDU Expectation 


30 


Cyclic EF, Enhanced mode, search forward 

from next record, start from an offset in 

record 

mode = ENHANCED_MODE 

searchIndication= 

SEARCH_INDICATION_START_FORWARD_FROM_NEX 

T + 0x0009 

recordNum = 

patt []={0x01, 0x02, 0x03} 

pattOffset = 

pattLength = 3 

response[] = {0,0,0,0,0} 

respOffset = 2 

respLength = 3 

searchRecord () 


shall return 3 
response shall be: 
response={0, 0,4,5,6} 




31 


Cyclic EF, Enhanced mode, search forward 

from next record, start from a value in 

record 

mode = ENHANCED_MODE 

searchIndication= 

SEARCH_IND I CAT I ON_S TART_FORWARD_FROM_NEX 

T + 0x0810 

recordNum = 

patt []={0x01, 0x02, 0x03} 

pattOffset = 

pattLength = 3 

response}] = {0,0,0,0,0} 

respOffset = 2 

respLength = 3 

searchRecord ( ) 


shall return 
response shall be: 
response={0,0,0,0,0} 




32 


Cyclic EF, Enhanced mode, search forward 

from next given record, start from an offset 

in record 

mode = ENHANCED_MODE 

sear chlndi cat ion= 

SEARCH_INDICATION_START_FORWARD_FROM_NEX 

T_GR + 0x0005 

recordNum = 3 

patt []={0x01, 0x02, 0x03} 

pattOffset = 

pattLength = 1 

response[] = {0,0,0,0,0} 

respOffset = 

respLength = 5 

searchRecord ( ) 


shall return 5 
response shall be: 
response={3,4,5,6,1} 




33 


Cyclic EF, Enhanced mode, search forward 

from next given record, start from a value in 

record 

1- mode = ENHANCED_MODE 
sear chlndi cat ion= 

SEARCH_IND I CAT I ON_S TART„FORWARD_FROM_NEX 

T_GR + 0x0805 

recordNum = 6 

patt [ ] ={OxOE, OxOF, 0x00} 

pattOffset = 

pattLength = 2 

response[] = {0,0,0,0,0} 

respOffset = 

respLength = 5 

searchRecord ( ) 

2- Restore EF initial state (record 1 
shall be assigned to the record that 
content is 

{0x01, 0x02, 0x03, 0x04, 0x05, 0x06, 0x07, 0x08 
, 0x09, OxOA, OxOB, OxOC, OxOD, OxE, OxOF} ) 
using 5 updateRecord ( ) in previous mode 


1- shall return 2 
response shall be: 
response={2,4,0,0,0} 
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Id 


Description 


API Expectation 


APDU Expectation 


34 


Cyclic EF, Enhanced mode, search 

backward from previous record, start from 

an offset in record 

1- Set current record pointer to record 
6 using 5 readRecordO in next mode 

2- mode = ENHANCED_MODE 
sear chlndi cat ion= 

SEARCH_INDICATION_START_BACKWARD_FROM_PR 
EVIOUS + 0x0003 

recordNum = 
patt []={ 0x02, 0x01, 0x00} 
pattOffset = 
pattLength = 2 
response!] = {0,0,0,0,0} 
respOffset = 3 
respLength = 2 
searchRecord {) 


2- shall return 1 
response shall be: 
response={0,0,0,6,0} 




35 


Cyclic EF, Enhanced mode, search 

backward from previous record, start from a 

value in record 

mode = ENHANCED_MODE 

sear chlndi cat ion= 

SEARCH_INDICATION_START_BACKWARD_FROM_PR 

EVIOUS + 0x0801 

recordNum = 

patt []={0x01, 0x02, 0x03} 

pattOffset = 1 

pattLength = 2 

response!] = {0,0,0,0,0} 

respOffset = 

respLength = 5 

searchRecord {) 


shall return 5 
response shall be: 
response={5,4,3,2,1} 




36 


Cyclic EF, Enhanced mode, search 

backward from given record, start from an 

offset in record 

mode = ENHANCED_MODE 

searchIndication= 

SEARCH_INDICATION_START_BACKWARD_FROM_PR 

EVIOUS_GR + 0x0003 

recordNum = 5 

patt !] = {0x02, 0x01, 0x00} 

pattOffset = 

pattLength = 2 

response!] = {0,0,0,0,0} 

respOffset = 3 

respLength = 2 

searchRecord () 


shall return 1 
response shall be: 
response={0,0,0,6,0} 




37 


Cyclic EF, Enhanced mode, search 

backward from given record, start from a 

value in record 

mode = ENHANCED_MODE 

searchIndication= 

SEARCH_INDICATION_START_BACKWARD_FROM_PR 

EVIOUS + 0x0801 

recordNum = 3 

patt !]={0x01, 0x02, 0x03} 

pattOffset = 1 

pattLength = 2 

response!] = {0,0,0,0,0} 

respOffset = 

respLength = 5 

searchRecord ( ) 


shall return 5 
response shall be: 
response={3,2,1,5,4} 
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5.3.1.13 Method increase 

Test Area Reference: Api_4_Afv_Incr. 

5.3.1.13.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short increase (byte [ ] incr, 

short incrOffset, 
short incrLength, 
byte [ ] resp, 
short respOffset) 
throws Java . lang. NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
UICCException 

5.3.1.13.1.1 Normal execution 

• CRRNl: This method increases the current cyclic EF record. 

• CRRN2: The response buffer will only contain the value of the increased record. 

5.3.1.13.1.2 Parameter errors 

• CRRPl : If the array incr is null, an instance of NullPointerException shall be thrown. 

• CRRP2: If the array resp is null, an instance of NullPointerException shall be thrown. 

• CRRP3: If incrOffset is negative, an instance of ArraylndexOutOfBoundsException shall be thrown. 

• CRRP4: If incrLength is negative, an instance of ArraylndexOutOfBoundsException shall be thrown. 

• CRRP5: If respOffset is negative, an instance of ArraylndexOutOfBoundsExceptoin shall be thrown. 

• CRRP6: If incrOffset plus incrLength, is greater than the length of array incr, an instance of 
ArraylndexOutOfBoundsException shall be thrown and no increase is performed. 

• CRRP7: If respOffset is greater than the length of array resp, an instance of 
ArraylndexOutOfboundsException shall be thrown. 

• CRRP8: If the result of the addition is greater than the maximum value of the record (represented by all bytes 
set to 'FF'), an instance of UICCException shall be thrown. The reason code shall be 
UICCException.MAX_VALUE_REACHED. 

• CRRP9: If incrLength is greater than 127, and exception shall be thrown. 

5.3.1.13.1.3 Context errors 

• CRRCl : If the calling applet has currently no EF selected, an instance of UICCException shall be thrown. The 
reason code shall be UICCException.NO_EF_SELECTED. 

• CRRC2: If the method call causes a memory problem (e.g. memory access error), an instance of 
UICCException. shall be thrown. The reason code shall be UICCException.MEMORY_PROBLEM. 

• CRRC3: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
UICCException shall be thrown. The reason code shall be UICCException.INTERNAL_ERROR. 

• CRRC4: If file is not a cyclic one, an instance of the UICCException shall be thrown. The reason code shall be 
UICCException.COMMANDJNCOMPATIBLE. 

• CRRC5: If the calling applet does not fulfil the access condition, INCREASE, to perform this function, an 
instance of UICCException shall be thrown. The reason code shall be 
UICCException.SECURITY_STATUS_NOTSATISFIED. 
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• CRRC6: If the currently selected EF is invalidated, an instance of UICCException shall be thrown. The reason 
code shall be UICCException.REF_DATA_INVALIDATED. 

• CRRC7: If the currently selected cyclic EF has no record, an instance of UICCException shall be thrown. The 
reason code shall be UICCException.NO_RECORD_FOUND. 



5.3.1.13.2 

Test Source: 
Test Applet: 
Cap File: 

5.3.1.13.3 



Test areafiles 

Test_Api_4_Afv_Incr.j ava. 
Api_4_Afv_Incr_ 1 .j ava. 
Api_4_Afv_incr.cap . 

Test coverage 



CRR number 


Test case number 


N1 


1,2,3, 15 


N2 


2,3,15 


P1 


4 


P2 


9 


P3 


6 


P4 


5 


P5 


10 


P6 


7 


P7 


11 


P8 


8 


P9 


15 


C1 


1 


C2 


Not testable 


C3 


Not testable 


C4 


12 


C5 


13 


C6 


14 


C7 


Not testable 



5.3.1.13.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


No EF selected 

1- select DFiEST fid=llll 

2- byte [ ] incr = new byte [4] 
byte [ ] resp = new byte [4] 
incrOffset = 
incrLength = 2 
respOffset = 

increase () 


2- An 

UICCException. NO_EF_SEL 

ECTED should be thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


2 


increase , verify response 

1- select EFcsRo, fid=6F09 

set the record pointer with 

readRecordO in PREVIOUS mode 

2-//Set both record to 00 00 00 

mode = REC_ACC_MODE_PREVIOUS 

data[] = {0x00,0x00,0x00} 

recOffset = 

dataOffset = 

dataLength = 3 

updateRecord ( ) //update Record 1 

updateRecord //update Record 2 

3- incr[] = {0x00,0x00,0x01} 

incrOffset = 

incrLength = 3 

resp. length = 4 

respOffset = 

ret = 3 

increase ( ) 


3- resp[] = 
{0x00,0x00,0x01,0x00} 




3 


increase, verify file 

1- incr []={OxOO, 0x00, 0x00, 0x02} 
incrOffset = 1 

incrLength = 3 
resp. length = 4 
respOffset = 1 
increase () 

2- resp[] = {0x00,0x00,0x00,0x00} 
recNumber = 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 

recOffset = 

resp. length =4 

respOffset = 

respLength = 3 

readRecord () 


1- resp[] = 
{0x00,0x00,0x00,0x03} 

2- respG = 
{0x00,0x00,0x03,0x00} 




4 


incr[] is null 

incr [ ] = null 
incrOffset = 
incrLength = 1 
resp. length = 4 
respOffset = 

increaseO 


Shall throw 

java.lang.NullPointerExceptio 

n. 




5 


incrLength< 

incr. length = 4 
incrOffset = 
incrLength = -1 
resp. length = 4 
respOffset = 
increase ( ) 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsExc 

option. 




6 


incrOffset < 

incr . length = 4 
incrOffset = -1 
incrLength = 1 
resp. length = 4 
respOffset = 
increase () 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsExc 

option. 




7 


IncrOffset + incrLength > incr.length 

incr . length = 4 

incrOffset = 1 

incLength = 4resp. length = 4 

respOffset = 

increase {) 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsExc 

option. 
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Id 


Description 


API Expectation 


APDU Expectation 


8 


Reach Maximum Value 

1- incr[0:3] = OxFF 
incrOffset = 
incrLength = 3 
resp.length = 4 
respOffset = 
increase () 

2- //Set both record to FF FF FF 
mode = REC_ACC_MODE_PREVIOUS 
data[] = {OxFF, OxFF, OxFF} 
recOffset = 

dataOffset = 

dataLength = 3 

updateRecord //update Record 1 

updateRecord ( ) //update Record 2 

3- incr[] = {0x00,0x00,0x01} 
incrOffset = 
incrLength = 3 
resp.length = 4 
respOffset = 

increase () 


1- Shall throw 

uicc. access. UlCCException 

with reason code 

MAX_VALUE_REACHED. 

2- Shall throw 

uicc. access. UlCCException 

with reason code 

MAX_VALUE_REACHED. 




9 


resp[] is null 

incr. length = 4 
incrOffset = 
incrLength = 1 
resp[] = null 
respOffset = 
increase () 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsExc 

eption. 




10 


respOffset < 

incr. length = 4 
incrOffset = 
incrLength = 1 
resp.length = 4 
respOffset = -1 
increase () 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsExc 

eption. 




11 


respOffset + recordLength > resp.length 

incr. length = 4 
incrOffset = 
incrLength = 3 
resp.length = 3 
respOffset = 2 
increase () 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsExc 

eption. 




12 


EF is not Cyclic 

1- select EFiaEo fid= 6F03 

2- incr . length= 3 
incrOffset = 
incrLength = 3 
resp.length = 3 
respOffset = 
increase () 

3 - select EFlaro, fid=6F0C 

4 - incr . length= 3 
incrOffset = 
incrLength = 3 
resp.length = 3 
respOffset = 
increase () 


2 - Shall throw 
uicc. access. UlCCException 
with reason code 
COMMAND INCOMPATIBL 

E. 

4 - Shall throw 
uicc. access. UlCCException 
with reason code 
COMMAND INCOMPATIBL 

E. 




13 


Access condition not fulfilled 

1- select EFcNic, fid=6F06 

2- incr.length= 3 
incrOffset = 
incrLength = 3 
resp.length = 3 
respOffset = 
increase () 


2 - Shall throw 

uicc. access. UlCCException 

with reason code 

SECURITY STATUS NOT 

SATISFIED. 
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Id 


Description 


API Expectation 


APDU Expectation 


14 


EF is invalidated 

l-select EFcaro, fid=6F09 

2 - invalidate 

3 - incr.length= 3 
incrOffset = 
incrLength = 3 
resp. length = 3 
respOffset = 
increase ( ) 

4 - rehabilitate ( ) 

5- Restore initial content of EFcaru 


3 - Shall throw 

uicc. access. UlCCException 

with reason code 

REF_DATA_INVALIDATED 




15 


incrLength out of range 

1- Create an EF Cyclic with 1 record of 
0x7F length, fid=0x2C7F 

2- Select EF Cyclic, fid=0x2C7F 

3- Set record to following value rec[0] 
= 0; rec[1..126] = OxFF with an update 
record. 

4- incr.length=128 
incrOffset = 1 
incrLength = 127 
resp. length = 255 
respOffset = 

Incr[] initialized to = {0x00,... 

,0x00,0x01} 

respOffset = 

ret = 0x7F 

increase () 

5- incr . length=128 
incrOffset = 
incrLength = 128 
resp. length = 255 
respOffset = 

Incr[] initialized to 
respOffset = 
increase () 

6- Delete EF Cyclic with fid=0x2C7F 


4-resp[0..126] = 

{0x01, 0x00,0x00,. ..,0x00} 

5- Shall throw an exception 





5.3.1 .14 Method deactivateFile 

Test Area Reference: Api_4_Afv_Dacf. 

5.3.1.14.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void deactivateFile ( ) 

throws UlCCException 

5.3.1.14.1.1 Normal execution 

• CRRNl: The currently selected EF of the calling applet shall be deactivated, as defined in TS 102 222. 

5.3.1.14.1.2 Parameter errors 
No requirements. 

5.3.1.14.1.3 Context errors 

• CRRCl: If the calling applet has currently no EF selected, an instance of UlCCException shall be thrown. The 
reason code shall be UICCException.NO_EF_SELECTED. 

• CRRC2: If the calling applet does not fulfil the access condition, activate, to perform this function, an instance 
of UlCCException shall be thrown. The reason code shall be 
UICCException.SECURITY_STATUS_NOT_SATISFIED. 



ETSI 



Release 6 



500 



ETSI TS 102 268 V6.0.0 (2007-03) 



• CCRC3: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
UICCException shall be thrown. The reason code shall be UICCException.INTERNAL_ERROR. 



5.3.1.14.2 

Test Source: 
Test Applet: 
Cap File: 

5.3.1.14.3 



Test area files 

Test_Api_4_Afv_Dacf.j ava. 
Api_4_Afv_Dacf_l .Java. 
Api_4_Afv_dacf.cap. 

Test coverage 



CRR number 


Test case number 


N1 


2,3 


C1 


1 


C2 


4 


C3 


Not testable 



5.3.1.14.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Test applet is installed with no access 
right on Application Pin2 






1 


No EF is selected 

1- select DFiEST fid=llll 

2- call deactivateFile 


2- An UICCException 
NO_EF_SELECTED is 
thrown 




2 


Deactivate activated File 

0- Select root directory 

1- Select EFoicc fid=2FF0 

2- ReadBinary EFuicc 

3- Deactivate EFuicc 

4- ReadBinary EFuicc 


2- No Exception shall be 

thrown 

4- 

UlCCException.REF DATA 

INVALIDATED is thrown 




3 


Deactivate deactivated File 

1- deactivateFile EFuicc 

2- activateFile EFuicc 


1- No Exception shall be 
thrown 




4 


Access condition not fulfilled 

1- select DFiEST fid=llll 

2- select EFlsda fid=6F15 

3- deactivateFile EFlsda 


3- An UICCException 
SECURITY STATUS NOT 
SATISFIED is thrown 





5.3.1 .15 Method activateFile 

Test Area Reference: Api_4_Afv_Actf. 

5.3.1 .1 5.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void activateFile ( ) 

throws UICCException 



ETSI 



Release 6 



501 



ETSI TS 102 268 V6.0.0 (2007-03) 



5.3.1.15.1.1 Normal execution 

• CRRNl: The currently selected EF of the calling applet shall be activated, as defined in TS 102 222. 

5.3.1.15.1.2 Parameter errors 
No requirements. 

5.3.1.15.1.3 Context errors 

• CRRCl : If the calling applet has currently no EF selected, an instance of UICCException shall be thrown. The 
reason code shall be UICCException. NO_EF_SELECTED. 

• CRRC2: If the calling applet does not fulfil the access condition, activate, to perform this function, an instance 
of UICCException shall be thrown. The reason code shall be 
UICCException.SECURITY_STATUS_NOT_SATISFIED. 

• CRRC3: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
UICCException shall be thrown. The reason code shall be UICCException.INTERNAL_ERROR. 



5.3.1.15.2 

Test Source: 
Test Applet: 
Cap File: 

5.3.1.15.3 



Test area files 

Test_Api_4_Afv_ Actf .j ava. 
Api_4_Afv_Actf_l .Java. 
Api_4_Afv_actf cap . 

Test coverage 



CRR number 


Test case number 


N1 


2,3 


CI 


1 


C2 


4 


C3 


Not testable 



5.3.1.15.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Test applet is installed with no access 
right on Application Pin2 






1 


No EF is selected 

1- Select DFiEST fid=llll 

2- Call activateFileO 


2- A UICCException NO_EF_SELECTED is 
thrown 




2 


Activate deactivated File 

0- Select Root directory 

1- Select EFoicc fid=2FF0 

2- ReadBinary EFuicc 

3- Deactivate EFuicc 

4- ReadBinary EFoicc 

5 -ActivateFile EFuicc 
6- ReadBinary EFuicc 


2- No Exception sliall be thrown 
4- 

UICCException.REF_DATA_INVALIDATED 
is thrown 
6- No Exception shall be thrown 




3 


Activate activated File 

ActiveFile EFuicc 


No Exception shall be thrown 




4 


Access condition not fulfilled 

1- Select DFiEST fid=llll 

2- Select EFlsda fid=6F15 

3- ActivateFile EFlada 


3- A UICCException 

SECURITY_STATUS_NOT_SATISFIED is 
thrown 
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5.3.2 Class AdminFileViewBuilder 
5.3.2.1 Method getTheUICCAdminFileView 

Test Area Reference: Api_4_Afb_Gtafb. 

5.3.2.1.1 Conformance requirement 

The method with following header shall compliant to its definition in the API. 

public static AdminFileView getTheUICCAdminFileView (byte event) 
throws javacard. framework . SystemException 

5.3.2.1 .1 .1 Normal execution 

CRRNl: returns a reference to class which implements the FileView interface on the UICC file system. 

CRRN2: return null if one of the javacard.framework.Applet.register(..) method has not previously invoked by 
the applet invoking this method or the filesystem server returns null. 

CRRN3: It is not possible to get access to files which are located under any ADF with this FileView. 

CRRN4: After a successful invocation of the method, the MF is the current selected file. 

CRRN5: A separate and independent file context shall be associated with each and every FileView object: the 
operation performed on files in a given FileView object shall not affect the file context associated with any 
other FileView object. This context can be transient or persistent depending on what was required by the 
Applet during the creation of the FileView object. 

5.3.2.1.1.2 Parameter errors 

• CRRPl : If event is not one of the following values JCSystem.NOT_A_TRANSIENT_OBJECT, 
JCSystem.CLEAR_ON_DESELECT, or JCSystem.CLEAR_ON_RESET a SystemException is thrown. The 
value of the SystemException shall be SystemException.ILLEGAL_V ALUE. 

5.3.2.1.1.3 Context errors 

• CRRCl : If event is JCSystem.CLEAR_ON_RESET or JCSystem.CLEAR_ON_DESELECT and not enough 
transient memory space is available a SystemException shall be thrown with reason code 
SystemException.NO_TRANSIENT_SPACE. 

• CRRC2: If event is JCSystem.CLEAR_ON_DESELECT and the applet is not a currently selected applet a 
SystemException with reason code SystemException.ILLEGAL_TRANSIENT shall be thrown. 

5.3.2.1.2 Test area files 

Test Source: Test_ Api_4_Afb_Gtafb.java. 
Test Applet: Api_4_Afb_Gtafb_l.java. 

Cap File: api_4_Afb_Gtafb.cap. 
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5.3.2.1.3 



Test coverage 



CRR number 


Test case number 


N1 


2 


N2 


1 


N3 


2 


N4 


2 


N5 


3 


P1 


7 


C1 


5,6 
Testable only if available transient space is lower than 32767 


C2 


4 
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5.3.2.1.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Method returns null 

Install Appletl with full access rights on 
the UICC file system 








Invoke the method getlheUICCView before the 


returns null 






javacard. framework .Applet . register ( . . ) 






method invocation 






2 


Normal execution 








1- Envelope menu selection is sent to the 
UICC 


1- Appletl is triggered 






Invoke the method getlheUICCView () with the 


No exception shall be thrown 






event JCSystem.NOT_A_TRANSIENT_OBJECT 








and stores the result in a class variable 








FVl 


Current selected DF is the MF 






Appletl calls status command 








Select DFiest using FVl 








Select EFiaHo using FVl 

Read first 3 bytes using FVl 


Expected value is {FF FF FF} 






Reset 








Terminal profile 








2- Envelope menu selection is sent to the 


2- Appletl is triggered 






UICC 


Current selected DF is DFjest 






Appletl calls FVl. status command 


UICCExGeption.FILE_NOT_FOU 






Appletl calls FVl . select (0x7FFF) 


ND is thrown 






Invoke the method getlheUICCView () with the 


No exception shall be thrown 






event JCSystem.CLEAR_ON_RESET and stores the 








result in a class variable FV2 








Appletl calls FV2. status () command 


Current selected DF the MF 






Select DFiest using FV2 








Select EFtaho using FV2 








Read first 3 bytes using FV2 


Expected value is {FF FF FF} 






Reset 








Terminal profile 








4 - Envelope menu selection is sent to the 


4- Appletl is triggered 






UICC 


Current selected DF is the IVIF 






Appletl calls status () command 


UICCException.FILE_NOT_FOU 






Appletl calls select (0x7FFF) 


ND is thrown 






5- Select the Applet by AID 


5- Appletl is selected 






Invoke the method in the method process () 


No exception shall be thrown 






getlheUICCView with the event 








JCSystem.CLEAR_ON_DESELECT and stores the 








result in a class variable 








Appletl calls status () command 


Current selected DF the MF 






Select DFiest using FV3 








Select EFtaro using FV3 








Read first 3 bytes using FV3 


Expected value is {FF FF FF} 






Select ADF2 by AID 








6- Select the Applet by AID 


6- Appletl is selected 
Current selected DF is the MF 
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Id 


Description 


API Expectation 


APDU Expectation 




Appletl calls status () command 
Appletl calls select (0x7FFF) 


UICCException.FILE_NOT_FOU 
ND is thrown 




3 


Fileview context independency 

1- Envelope menu selection is sent to the 
Dice 

2- Check that previous fileviews are 
different (FVl != FV2 != FV3) 

3- Select DFiest/EFLSRn using FVl 

4- Select DFiest/EFcsRn using FV2 

5- Select DFiest/EFcaRn using FV3 

6- Read record number 1 using FVl (in 
absolute mode) 

7- Read record number 2 using FV2 (in 
absolute mode) 


1- Appletl is triggered 

3- No exception shall be thrown 

4- No exception shall be thrown 

5- An exception is thrown 

6- Expected value is "55 55 55 
55" 

7- Expected value is "AA AA AA" 




4 


ILLEGAL_TRANSIENTSystemException 

1- Envelope menu selection is sent to the 

UICC 

2- Appletl calls getTheUICCView () method 
with the event JCSystem. CLEAR_ON_DESELECT 


1- Appletl is triggered 

2- System Exception. 
ILLEGAL_TRANSIENT is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


5 


NO TRANSIENT SPACESystemException 
with CLEAR_ON_RESET Fileview object 

1- Get the available transient memory space 
using method 

length= JCSy stem. get Aval lableMemory (MEMORY_TY 
PE_TRANSIENT_RESET) 

2- If length < 32767, (test case could be 
performed) 

2.1- Fill the available transient memory 
space by creating array, using method 
JCSystem.makeTransientByteArray (length, 
JCSy stem. CLEAR_ON_RESET) 

2.2- Applet calls method getTheUICCView () 
with event 

JCSy stem. CLEAR„ON„RESET 

4- Reset 


1- No exception shall be thrown 

2.1- No exception shall be 
thrown 

2.2- SystemException. 
NO_TRANSIENT_SPACE is 
thrown 




6 


NO TRANSIENT SPACE System Exception 
with CLEAR_ON_DESELECT Fileview object 

1- Select the Applet by AID 

2- Get the available transient memory space 
using method 

length=JCSystem.getAvailableMemory (MEMORY_TY 
PE_TRANSIENT_DESELECT) 

3- If length < 32767, (test case could be 
performed) 

3.1- Fill the available transient memory 
space by creating array, using method 
JCSystem.makeTransientByteArray (length, 
JCSy stem. CLEAR„ON_DESELECT) 

3.2- Applet calls method getTheUICCView ( ) 
with event 

JCSy stem. CLEAR_ON_DESELECT 

4- Reset 


1- Appletl is selected 

2- No exception shall be thrown 

3.1- No exception shall be 
thrown 

3.2- SystemException. 
NO_TRANSIENT_SPACE is 
thrown 




7 


ILLEGAL_VALUE System Exception 

Invoke the method getTheUICCView ( ) with 
every event codes except 0,1,2 


1- 

SystemException.il 1 FGAL VAL 

UE is thrown 





5.3.2.2 Method getTheAdminFileView(javacard.framework.AID aid, byte event) 

Test Area Reference: Api_4_Afb_Gtafob. 

5.3.2.2.1 Conformance requirement: 

The method with following header shall compliant to its definition in the API. 

public static AdminFileView getXheAdminFileView ( javacard. framework. AID aid, byte event) 
throws NullPointerException, 

javacard. framework . SystemException 



5.3.2.2.1.1 



Normal execution 



• CRRN 1 : returns a reference to class which implements the AdminFileView interface on an ADF file system 
defined by is AID. 

• CRRN2: returns null if the ADF with the AID does not exist. 
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CRRN3: returns null if one of the javacard. framework. Applet.register(..) method has not previously invoked 
by the applet invoking this method or the filesystem server does not exist or the filesystem server returns null. 

CRRN4: After a successful invocation of the method the ADF is the currently selected file. 

CRRN5: A separate and independent file context shall be associated with each and every AdminFileView 
object: the operation performed on files in a given AdminFileView object shall not affect the file context 
associated with any other AdminFileView object. This context can be transient or persistent depending on 
what was required by the Applet during the creation of the AdminFileView object. 

CRRN6: It is not possible to access files which are not located under the ADF. 



5.3.2.2.1.2 



Parameter errors 



CRRPl: If event is not one of the following values JCSystem.NOT_A_TRANSIENT_OBJECT, 
JCSystem.CLEAR_ON_DESELECT, or JCSystem.CLEAR_ON_RESET a SystemException is thrown. The 
value of the SystemException shall be SystemException.ILLEGAL_V ALUE. 

CRRP2: If the AID is null a NullPointerException shall be thrown. 



5.3.2.2.1.3 



Context errors 



• CRRCl : If event is JCSystem.CLEAR_ON_RESET or JCSystem.CLEAR_ON_DESELECT and not enough 
transient memory space is available a SystemException shall be thrown with reason code 
SystemException.NO_TRANSIENT_SPACE. 

• CRRC2: If event is JCSystem.CLEAR_ON_DESELECT and the applet is not a currently selected applet a 
SystemException with reason code SystemException.ILLEGAL_TRANSIENT shall be thrown. 



5.3.2.2.2 

Test Source: 
Test Applet: 
Cap File: 



Test area files 

Test_ Api_4_Afb_Gtafob.java. 
Api_4_Afb_Gtafob.java. 
api_4_Afb_Gtafob . cap . 



5.3.2.2.3 



Test coverage 



CRR number 


Test case number 


N1 


1 to 3 


N2 


1 


N3 


1 


N4 


2 


N5 


3 


N6 


2 


PI 


7 


P2 


8 


CI 


5,6 
Testable only if available transient space is lower than 32767 


C2 


4 
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5.3.2.2.4 



Test procedure 



Id 



Description 



API Expectation 



APDU Expectation 



Method returns null 

1- Install Appletl with full access rights 
on the UICC file system 

2- Invoke the method getTheAdminFileView 
before the 

javacard. framework .Applet . register (..) 
method invocation 

3- Envelope menu selection is sent to the 

UICC 

4- Invoke the method getTheAdminFileView () 
with AID = unknown ADF AID 



2- returns null 

3- applet Is triggered 

4- returns null 



Normal execution 

1- Envelope menu selection is sent to the 
UICC 

Invoke the method getTheAdminFileView ( ) 

with AID = ADFl with the event 

JCSy stem . NOT_A_TRANS IENT_OB JECT 

and stores the result in a class variable 

FVl 

Appletl calls FVl. status () command 



Select DFTest using FVl Select EFTARU 
using FVlRead first 3 bytes using FVl 

Reset 

Terminal profile 

2 - Envelope menu selection is sent to the 
UICC 

Appletl calls FVl. status () command 

Read first 3 bytes using FVl 

Appletl calls FVl. select (EFRFUl) 



Invoke the method getTheAdminFileView () 
with the event JCSy stem. CLEAR_ON_RESET and 
stores the result in a class variable FV2 

Appletl calls FV2. status () command 

Select DFTest using FV2 
Select EFTARU using FV2 
Read first 3 bytes using FV2 

Reset 

Terminal profile 

4 - Envelope menu selection is sent to the 
UICC 

Appletl calls FV2. status () command 

Read first 3 bytes using FV2 



Appletl calls FV2 . select (EFRFUl) 



5- Select the Applet by AID 

Invoke the method getTheAdminFileView () 

with AID = ADFl with the event: 



1- Appletl Is triggered 

No Exception shall be thrown 

Current selected DF is ADF1 
Expected value Is {FF FF FF} 

2- Appletl Is triggered 

Current selected DF Is DFjest 

Expected value Is {FF FF FF} 

UlCCExceptlonUICCExceptlon.FIL 
E_NOT_FOUND is thrown 

No exception shall be thrown 
Current selected DF Is the ADF1 

Expected value Is {FF FF FF} 

4- Appletl Is triggered 

Current selected DF Is the ADF1 

UlCCExceptlon. 
NO EF SELECTED 



UlCCExceptlon. FILE_NOT_FOUN 
D Is thrown 

5- Appletl Is selected 
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Id 


Description 


API Expectation 


APDU Expectation 




JCSystem.CLEAR_ON_DESELECT and stores the 
result in a class variable FV3 

Appletl calls FV3. status () command 
Select DFTest using FV3 Select EFTARU 
using FV3 
Read first 3 bytes using FV3 

6- Select the Applet by AID 
Appletl calls FV3. status () command 

Read first 3 bytes using FV3 
Appletl calls FV3 . select (EFRFUl) 


No Exception shall be thrown 
Current selected DP is ADF1 

Expected value is {FF FF FF} 

6- Appletl is selected 

Current selected DF is ADF1 

UICCException.NO_EF_SELECTE 
D shall be thrown 

UICCException.FILE_NOT_FOUN 
D shall be thrown 




3 


FileView context independency 

1- Envelope menu selection is sent to the 
UICC 

2- Check that previous fileviews are 
different (FVl != FV2 != FV3) 

3- Select DFTest/EFLARU using FVl 

4- Select DFTest/EFCARU using FV2 

5- Select DFTest/EFCARU using FV3 

6- Read record number 1 using FVl (in 
absolute mode) 

7- Read record number 2 using FV2 (in 
absolute mode) 


1- Appletl is triggered 

3- No exception shall be thrown 

4- No exception shall be thrown 

5- An exception shall be thrown 

6- Expected value is "55 55 55 55" 

7- Expected value is "AA AA AA" 




4 


ILLEGAL_TRANSIENTSystemExceptlon 

1- Envelope menu selection is sent to the 
UICC 

2- Appletl calls getlheAdminFileView () 
method with the event 
JCSystem.CLEAR_ON_DESELECT 


1- Appletl is triggered 

2- SystemException. 
ILLEGAL_TRANSIENT is thrown 




5 


NO TRANSIENT SPACE SystemException 
with CLEAR_ON_RESET FileView object 

1 Get the available transient memory 

space using method length = 

JCSystem. get Aval lableMemory(MEMORY_TYPE_TR 

ANSIENT_RESET) 

2- If length < 32767, (test case could be 
performed) 

2.1- Fill the available transient memory 
space by creating array, using method 
JCSystem.makeTransientByteArray (length, 
JCSystem. CLEAR_ON_RESET) 

2.2- Applet calls method 
getlheAdminFileView with AID = ADFl 

with event 
JCSystem. CLEAR„ON_RESET 


1- No Exception shall be thrown 

2.1- No Exception shall be thrown 

2.2- 

System Exception. NO TRANSIENT 

_SPACE is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


6 


NO TRANSIENT SPACE SystemException 
with CLEAR_ON_DESELECT FileView object 

1 - Select the Applet by AID 

2- Get the available transient memory 
space using method length = 

JCSystem.getAvailableMemory (MEMORY_TYPE_TR 
ANSIENT_DESELECT) 

3- If length < 32767, (test case could be 
performed) 

3.1- Fill the available transient memory 
space by creating array, using method 
JCSystem.makeTransientByteArray (length, 
JCSystem.CLEAR_ON_DESELECT) 

} 

3.2- Applet calls method 
getlheAdminFileView with AID = ADFl 

with event : 
JCSystem.CLEAR_ON_DESELECT 

4- Reset 


1- Appletl is triggered 

2- No Exception shall be thrown 

3.1- No Exception shall be thrown 

3.2- SystemException. 
NO_TRANSIENT_SPACE is 
thrown 




7 


ILLEGAL_VALUE SystemException 

1- Invoke the method getlheAdminFileView () 
with every event codes except: 0, 1, 2 


1- 

SystemException.lLLEGAL_VALU 
E is thrown 




8 


NullPointerException 

Invoke the method getlheAdminFileView () 
with AID = NULL 

with event : 
1 - JCSystem.CLEAR_ON_RESET 


1- Shall be thrown 

java.lang. NullPointerException 





5.3.2.3 Method getTheAdminFileView(byte[] buffer, short bOffset, short bLength, 

byte event) 

Test Area Reference: Api_4_Afb_Gtaf_Bsbb. 

5.3.2.3.1 Conformance requirement: 

The method with following header shall compliant to its definition in the API. 

public static AdminFileView getlheAdminFileView (byte [ ] buffer, short bOffset, short bLength, byte 
event) 

throws NullPointerException, 

javacard. framework . SystemException, 
ArraylndexOutOfBoundException 



5.3.2.3.1.1 



Normal execution 



CRRNl: returns a reference to class which implements the AdminFileView interface on an ADF file system 
defined by its AID. 

CRRN2: returns null if the ADF with the full AID given in the buffer does not exist. 

CRRN3: returns null if one of the javacard. framework.Applet.register(..) method has not previously invoked 
by the applet invoking this method or the filesystem server does not exist or the filesystem server returns null. 

CRRN4; After a successful invocation of the method the ADF is the currently selected file. 
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• CRRN5: A separate and independent file context shall be associated with each and every AdminFileView 
object: the operation performed on files in a given File View object shall not affect the file context associated 
with any other AdminFileView object. This context can be transient or persistent depending on what was 
required by the Applet during the creation of the AdminFileView object. 

• CRRN6: It is not possible to access files which are not located under the ADF. 

5.3.2.3.1.2 Parameters error 

• CRRPl : If event is not one of the following values JCSystem.NOT_A_TRANSIENT_OBJECT, 
JCSystem.CLEAR_ON_DESELECT, or JCSystem.CLEAR_ON_RESET a SystemException is thrown. The 
value of the SystemException shall be SystemException.ILLEGAL_V ALUE. 

• CRRP2: If the buffer is null a NullPointerException shall be thrown. 

• CRRP3: if bLength is less then 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

• CRRP4: if bOffset plus bLength is greater than the length of the array buffer. length, an instance of 
ArraylndexOutOfBoundsException shall be thrown. 

• CRRP5; if bLength is not in the range of 5 - 16 bytes a SystemException.ILLEGAL_VALUE shall be thrown. 

5.3.2.3.1.3 Context errors 

• CRRCl : If event is JCSystem.CLEAR_ON_RESET or JCSystem.CLEAR_ON_DESELECT and not enough 
transient memory space is available a SystemException shall be thrown with reason code 
SystemException.NO_TRANSIENT_SPACE. 

• CRRC2: If event is JCSystem.CLEAR_ON_DESELECT and the applet is not a currently selected applet a 
SystemException with reason code SystemException.ILLEGAL_TRANSIENT shall be thrown. 

5.3.2.3.2 Test area files 

Test Source: Test_ Api_4_Afb_Gtaf_Bsbb.java. 
Test Applet: Api_4_Afb_Gtaf_Bsbb.java. 

Cap File: api_4_Afb_Gtaf_Bsbb.cap. 

5.3.2.3.3 Test coverage 



CRR number 


Test case number 


N1 


2 


N2 


3 


N3 


1 


N4 


2 


N5 


11, 12 


N6 


5 


P1 


2 


P2 


5 


P3 


7 


P4 


8 


P5 


9 


CI 


11, 12 
Testable only if available transient space is lower than 32767 


C2 


6 
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5.3.2.3.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Method returns null 

1- Install Appletl with full access rights 
on the UICC file system 








2- Invoke the method getlheFileView 
before the 


2- returns null 






javacard. framework .Applet . register ( . . ) 








method invocation 








Invoke the method getTheAdminFileView () 








with buffer [20] = {ADFl,...} 








bOffset= 








bLength= 16 








3- Envelope menu selection is sent to the 


3- Applet is triggered 






UICC 








4- Invoke the method getTheAdminFileView 


4- returns null 






before the 








javacard. framework .Applet . register (..) 








method invocation 








Invoke the method getTheAdminFileView ( ) 








with buffer [] = unknown aid 






2 


Normal execution 








1- Envelope menu selection is sent to the 
UICC 


1- Appletl is triggered 






Invoke the method getTheAdminFileView () 
with buffer [20] = {ADFl,...} 


No Exception shall be thrown 






bOffset= 








bLength= 16 








JCSystem.NOT_A_TRANSIENT_OBJECT 








and stores the result in a class variable 








FVl 








Appletl calls FVl. status () command 


Current selected DF is ADF1 






Select DFTest using FVl 








Select EFTARU using FVl 








Read first 3 bytes using FVl 


Expected value is {FF FF FF} 






Reset 








Terminal profile 








2 - Envelope menu selection is sent to the 


2- Appletl is triggered 






UICC 








Appletl calls FVl. status () command 


Current selected DF is DFTest 






Read first 3 bytes using FVl 


Expected value is {FF FF FF} 






Appletl calls FVl . select (EFRFUl) 


UlCCExceptionUICCException.FIL 
E_NOT_FOUND is thrown 






Invoke the method getTheAdminFileView () 








with the event JCSystem.CLEAR_ON_RESET and 
stores the result in a class variable FV2 


No exception shall be thrown 






Appletl calls FV2. status () command 


Current selected DF is ADF1 






Select DFTest using FV2 








Select EFTARU using FV2 








Read first 3 bytes using FV2 


Expected value is {FF FF FF} 






Reset 








Terminal profile 








4 - Envelope menu selection is sent to the 


4- Appletl is triggered 






UICC 








Appletl calls FV2. status () command 


Current selected DF is ADF1 
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Read first 3 bytes using FV2 


UlCCException.NO EF SELECTE 
D. 






Appletl calls FV2 . select (EFRFUl) 


UICCException.FILE_NOT_FOUN 
D is thrown 






5- Select the Applet by AID 

Invoke the method getlheAdminFileView () 

with AID = ADFl with 


5- Appletl is selected 

No Exception shall be thrown 






buffer[20] = {ADFl,...} 








bOffset= 








bLength= 16 








the event :JCSy stem. CLEAR„ON_DESELECT and 








stores the result in a class variable FV3 








Appletl calls FV3. status () command 


Current selected DF is ADF1 






Select DFTest using FV3 








Select EFTARU using FV3 
Read first 3 bytes using FV3 


Expected value is {FF FF FF} 






6- Select the Applet by AID 


6- Appletl is selected 






Appletl calls FV3. status () command 


Current selected DF is ADF1 






Read first 3 bytes using FV3 


UlCCException.NO EF SELECTE 
D. 






Appletl calls FV3 . select (EFRFUl ) 


UICCException.FILE_NOT_FOUN 
D is thrown 
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3 


FileView context independency 

1- Envelope menu selection is sent to the 
UICC 

2- Check that previous fileviews are 
different (FVl != FV2 != FV3) 

3- Select DFTest/EFLARU using FVl 

4- Select DFTest/EFCARU using FV2 

5- Select DFTest/EFCARU using FV3 

6- Read record number 1 using FVl (in 
absolute mode) 

7- Read record number 2 using FV2 (in 
absolute mode) 


1- Appletl is triggered 

3- No exception shall be thrown 

4- No exception shall be thrown 

5- An exception shall be thrown 

6- Expected value is "55 55 55 55" 

7- Expected value is "AA AA AA" 




4 


ILLEGAL_TRANSIENTSystemException 

1- Envelope menu selection is sent to the 
UICC 

2- Appletl calls getTheAdminFileView () 
method with 

buffer[20] = {ADFl,...} 

bOffset= 

bLength= 16 

with 

the event JCSystem.CLEAR_ON_DESELECT 


1- Appletl is triggered 

2- SystemException. 
ILLEGAL_TRANSIENT is thrown 




5 


NO TRANSIENT SPACE SystemException 
with CLEAR_ON_RESET FileView object 

1- Get the available transient memory 
space using method length = 

JCSystem.getAvailableMemory (MEMORY_TYP_TRA 
NSIENT_RESET) 

2- If length < 32767, (test case could be 
performed) 

2.1- Fill the available transient memory 
space by creating array, using method 
JCSystem.makeTransientByteArray (length, 
JCSystem.CLEAR_ON_RESET) 

2.2- Applet calls method 

getTheAdminFileView with buffer [20] = 
{ADFl,...} 

bOffset= 

bLength= 16 

with the event 

JCSy stem . CLEAR_ON_RESET 


1- No Exception shall be thrown 

2.1- No Exception shall be thrown 

2.2- SystemException. 
NO_TRANSIENT_SPACE is 
thrown 
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6 


NO TRANSIENT SPACE SystemException 
with CLEAR_ON_DESELECT FileView object 

1 - Select the Applet by AID 

2- Get the available transient memory 
space using method length = 

JCSystem.getAvailableMemory (MEMORY_TYPE_TR 
ANSIENT_DESELECT) 

3- If length < 32767, (test case could be 
performed) 

3.1- Fill the available transient memory 
space by creating array, using method 
JCSystem.makeTransientByteArray (length, 
JCSystem.CLEAR_ON_DESELECT) 

} 

3.2- Applet calls method 

getlheAdminFileView with buffer [20] = 
{ADFl,...} 

bOffset= 
bLength= 16 
with event : 
JCSystem.CLEAR_ON_DESELECT 

4- Reset 


1- Appletl is triggered 

2- No Exception shall be thrown 

3.1- No Exception shall be thrown 

3.2- SystemException. 
NO_TRANSIENT_SPACE is 
thrown 




7 


ILLEGAL_VALUE SystemException 

1- Invoke the method getlheAdminFileView () 
with every event codes except: 0, 1, 2 


1- 

System Exception. ILLEGAL_VALU 

E is thrown 




8 


NullPointerException 

Invoke the method getlheAdminFileView () 
with buffer [20] = null 
bOffset= 
bLength= 16 

with event : 
1 - JCSystem.CLEAR_ON_RESET 


1- Shall be thrown 

java.lang. NullPointerException 




9 


ArraylndexOutOfBoundsException 

l-Envelope menu selection is sent to the 

UICC 

Invoke the method getlheAdminFileView () 

with buffer [20] = {ADFl,...} 

bOffset= 5 

bLength= 16 

event =JCSystem. CLEAR_ON_RESET 

Invoke the method getlheAdminFileView () 

with buffer [20] = {ADFl,...} 

bOffset= -1 

bLength= 16 

event =JCSystem. CLEAR_ON_RESET 


1- Appletl is triggered 

Shall be thrown 
ArraylndexOutOfBoundsException 

Shall be thrown 
ArraylndexOutOfBoundsException 
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10 



SystemException.lLLEGAL_VALUE 

l-Envelope menu selection is sent to the 
UICC 

Invoke the method getTheAdminFileView () 

with buffer[20] = {ADFl,...} 

bOffset= 

bLength= 4 

event =JCSystem. CLEAR_ON_RESET 

Invoke the method getTheAdminFileView () 

with buffer[20] = {ADFl,...} 

bOffset= 

bLength= 17 

event =JCSystem. CLEAR_ON_RESET 



1- Appletl is triggered 

System Exception. I LLEGAL_VALU 
E shall be thrown 



System Exception. I LLEGAL_VALU 
E shall be thrown 



5.3.3 Class AdminException 
5.3.3.1 Constructor 

Test Area Reference: Api_4_Aex_Coor. 

5.3.3.1.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public AdminException (short reason) 

5.3.3.1 .1 .1 Normal execution 

• CRRNl: Constructs an AdminException with the specified reason. 



5.3.3.1.1.2 

No requirements. 

5.3.3.1.1.3 

No requirements. 

5.3.3.1.2 

Test Source: 
Test Applet: 
Cap File: 

5.3.3.1.3 



Parameter errors 
Context errors 
Test area files 

Test_Api_4_Aex_Coor.j ava. 
Api_4_Aex_Coor_ 1 .j ava. 
Api_4_Aex_Coor.cap. 

Test coverage 



CRR number 


Test case number 


N1 


1 



5.3.3.1.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


AdminException with the specified reason 

(The reason shall set with setReason 
and compare the Exception with 
getReason) 


Reason (specified) 
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5.3.3.2 Method throwit 

Test Area Reference: Api_4_Aex_Thit. 

5.3.3.2.1 Conformance requirement 

The method with following header shall be compliant to its definition in the APT 

public static void throwit (short reason) 
throws AdminException 

5.3.3.2.1.1 Normal execution 

• CRRNl: Throws the JCRE instance of AdminException with the specified reason. 

• CRRN2: Etends javacard.framework.CardRuntimeException. 



5.3.3.2.1.2 

No requirements. 

5.3.3.2.1.3 

No requirements. 

5.3.3.2.2 

Test Source: 
Test Applet: 
Cap File: 

5.3.3.2.3 



Parameter errors 
Context errors 
Test area files 

Test_Api_4_Aex_Thit.j ava. 
Api_4_Aex_Thit_ 1 .j ava. 
Api_4_Aex_Thit.cap. 

Test coverage 



CRR number 


Test case number 


N1 


1,2,3 


N2 


4,5,6 



5.3.3.2.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Throws the JCRE Instance of AdminException 
with the specified reason 


Reason = 




2 


Throws the JCRE instance of AdminException 
with the specified reason 


Reason = 1 




3 


Throws the JCRE instance of AdminException 
with the specified reason 


Reason = 0xA55A 




4 


AdminException extends 
javacard.framework.CardRuntlmeException 


Reason = 




5 


AdminException extends 
javacard.framework.CardRuntimeException 


Reason = 1 




6 


AdminException extends 
javacard.framework.CardRuntlmeException 


Reason = 0xA55A 
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5.3.3.3 Reason Codes 

Test Area Reference: Api_4_Aex_Cons. 

5.3.3.3.1 Conformance Requirement: 

There is no API, only constants. These constants shall compliant to its definition in the API. 

5.3.3.3.1.1 Normal execution 

• CRRNl: The Constants of the class AdminException shall all have the same name and value defined in the 
TS 102 241 [13]. 

• CRRN2: Constructs AdminException an Exception with the specified reason. 



5.3.3.3.1.2 


Parameter errors 


No requirements. 




5.3.3.3.1.3 


Context errors 


No requirements. 




5.3.3.3.2 


Test area files 


None. 




5.3.3.3.3 


Test Coverage 



CRR number 


Test case number 


Nl & N2 


The constants in Java are resolved at compilation time, therefore a runtime test is not 
useful. No test of constants will be performed 



5.3.3.3.4 Test Procedure 

None. 

5.4 Package uicc.system 

5.4.1 Class HandlerBuilder 

5.4.1 .1 Method buildTLVHandler(byte type, short capacity) 

Test Area Reference: Api_3_Hdb_Bthdbs. 

5.4.1 .1 .1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public static ViewHandler buildTLVHandler (byte type, 

short capacity) 
throws Java . lang . ArraylndexOutOfBoundsException, 
javacard. framework . SystemException 

5.4.1.1.1.1 Normal execution 

• CRRNl: Allocates a TLVHandler with an internal buffer of length capacity. 
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5.4.1.1.1.2 



Parameter errors 



• CRRPl : If the type parameter does not match with the predefined values, a 
javacard.fi-amework.SystemException is thrown with ILLEGAL_VALUE reason code. 

• CRRP2: If capacity is negative, a javacard. framework. SystemException is thrown with ILLEGAL_VALUE 
reason code. 



5.4.1.1.1.3 



Context errors 



CRRCl: If there are not enough resources in the card to allocate the handler, a 
javacard. framework.SystemException is thrown with NO_RESOURCE reason code. 



5.4.1.1.2 

Test Source: 
Test Applet: 
Cap File: 

5.4.1.1.3 



Test area files 

Test_Api_3_Hdb_Bthdbs.java. 
Api_3_Hdb_Bthdbs_l .Java. 
api_3_hdb_bthdbs.cap. 

Test coverage 



CRR number 


Test case number 


N1 


1,2 


PI 


4,5 


P2 


3 


CI 


Not testable 



5.4.1.1.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call buildTLVHandlerO method with 
EDIT_HANDLER type 

Type = EDIT_HANDLER 

Capacity = (short) 10 

Check the created object is not null 


No exception shall be thrown 




2 


Call buildTLVHandlerO method with 
BER_EDIT_HANDLER type 

Type = BER_EDIT_HANDLER 

Capacity = (short) 10 

Check the created object is not null 


No exception shall be thrown 




3 


Negative capacity 

Type = EDIT_HANDLER 
Capacity = (short) -10 


A 

javacard.framework.SystemE 
xception is thrown with 
ILLEGAL_VALUE reason 
code.. 




4 


Type does not match with predefined 
values 

Type = (byte) 3 
Capacity = (short) 10 


javacard.framework.SystemE 
xception shall be thrown with 
ILLEGAL_VALUE reason 
code. 




5 


Type does not match with predefined 
values 

Type = (byte) 
Capacity = (short) 10 


javacard.framework.SystemE 
xception shall be thrown with 
ILLEGAL_VALUE reason 
code. 
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5.4.1 .2 Method buildTLVHandler(byte type, short capacity, byteQ buffer , short 

bOffset, short bLength) 

Test Area Reference: Api_3_Hdb_Bthdbs_Bss. 

5.4.1.2.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public static ViewHandler buildTLVHandler (byte type, 

short capacity, 
byte [ ] buffer, 
short bOffset, 
short bLength) 
throws Java . lang . ArraylndexOutOfBoundsException, 
javacard. framework . SystemException, 
Java . lang . NullPointerException 

5.4.1 .2.1 .1 Normal execution 

• CRRNl: Allocates a TLVHandler with an internal buffer of length capacity. 

• CRRN2: Copies the buffer content to an internal buffer of the TLVHandler starting at bOffset. 

• CRRN3: The internal buffer shall be at least bLength long. 

5.4.1.2.1.2 Parameter errors 

• CRRPl : If the type does not match with the predefined values, a javacard. framework. SystemException is 
thrown with ILLEGAL_VALUE reason code. 

• CRRP2: If buffer is null, a Java. lang. NullPointerException is thrown. 

• CRRP3: If bOffset would cause access outside array bounds, an java.lang. ArraylndexOutOfBoundsException 
is thrown. 

• CRRP4: if bLength is negative, a java.lang. ArraylndexOutOfBoundsException is thrown. 

• CRRP5: If capacity is negative, a javacard. framework.SystemException is thrown with ILLEGAL_VALUE 
reason code. 

• CRRP6: If bOffset+b Length is greater than the length of the buffer, a 
java.lang. ArraylndexOutOfBoundsException is thrown. 

5.4.1.2.1.3 Context errors 

• CRRCl: If there are not enough resources in the card to allocate the handler, a 
javacard. framework.SystemException is thrown with NO_RESOURCE reason code. 

5.4.1.2.2 Test area files 

Test Source: Test_Api_3_Hdb_Bthdbs_Bss.java. 
Test Applet: Api_3_Hdb_Bthdbs_Bss_l.java. 

Cap File: api_3_hdb_bthdbs_bss.cap. 
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5.4.1.2.3 



Test coverage 



CRR number 


Test case number 


N1 


1,2 


N2 


6 


N3 


1, 2, 6 


P1 


4,5 


P2 


7 


P3 


8,9 


P4 


10 


P5 


3 


P6 


11 


C1 


Not testable 



5.4.1.2.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call buildTLVHandlerO method with 
EDIT_HANDLER type 

Type = EDIT_HANDLER 

Capacity = (short) 10 

Buffer [10] 

Offset = (short) 

Length = (short) 

Check the created object is not null 


No exception shall be thrown 




2 


Call buildTLVHandlerO method with 
BER_EDIT_HANDLER type 

Type = BER_EDIT_HANDLER 

Capacity = (short) 10 

Buffer [10] 

Offset = (short) 

Length = (short) 

Check the created object is not null 


No exception shall be thrown 




3 


Negative capacity 

Type = EDIT_HANDLER 
Capacity = (short) -10 
Buffer [10] 
Offset = (short) 
Length = (short) 5 


A 

javacard.framework.SystemE 
xception is thrown with 
ILLEGAL_VALUE reason 
code.. 




4 


Type does not match with predefined 
values 

Type = (byte) 
Capacity = (short) 10 
Buffer [10] 
Offset = (short) 
Length = (short) 5 


A 

javacard.framework.SystemE 
xception shall be thrown with 
ILLEGAL_VALUE reason 
code. 




5 


Type does not match with predefined 
values 

Type = (byte) 3 
Capacity = (short) 10 
Buffer [10] 
Offset = (short) 
Length = (short) 5 


A 

javacard.framework.SystemE 
xception shall be thrown with 
ILLEGAL_VALUE reason 
code. 




6 


Internal Buffer starts at bOffset 

Type = EDIT_HANDLER 

Capacity = (short) 10 

Buffer [10] 

Offset = (short) 4 

Length = (short) 5 

Check the internal buffer of the 

TLVHandler starts with bOffset data. 


No exception shall be thrown 
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7 


Buffer is null 

Type = EDIT_HANDLER 
Capacity = (short) 10 
Buffer [] = null 
Offset = (short) 
Length = (short) 5 


A 

java.lang.NullPointerExceptio 
n shall be thrown. 




8 


bOffset > Buffer Length 

Type = EDIT_HANDLER 
Capacity = (short) 10 
Buffer [10] 
Offset = (short) 11 
Length = (short) 


A 

java.lang.ArraylndexOutOfBo 
undsException shall be 
thrown. 




9 


bOffset < 

Type = EDIT_HANDLER 
Capacity: (short) 10 
Buffer [10] 
Offset = (short) -1 
Length = (short) 


A 

Java.lang.ArraylndexOutOfBo 
undsException shall be 
thrown. 




10 


bLength < 

Type = EDIT_HANDLER 
Capacity = (short) 10 
Buffer [10] 
Offset = (short) 
Length = (short) -1 


A 

Java.lang.ArraylndexOutOfBo 
undsException shall be 
thrown. 




11 


bOffset+bLength > buffer length 

Type = EDIT_HANDLER 
Capacity = (short) 10 
Buffer [10] 
Offset = (short) 7 
Length = (short) 8 


A 

Java.lang.ArraylndexOutOfBo 
undsException shall be 
thrown. 





5.4.2 Interface UlCCPIatform 
5.4.2.1 Method getTheVolatileByteArray 

Test Area Reference: Api_3_Upf_Gvba. 

5.4.2.1.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public static byte[] getTheVolatileByteArray () 



5.4.2.1.1.1 



Normal execution 



CRRNl: Returns the instance of the volatile byte array designated by the JCRE as global array. The byte array 
length shall be at least equal to 256 bytes. 



5.4.2.1.1.2 
No requirement. 

5.4.2.1.1.3 



Parameter errors 



Context errors 



CRRCl: If the method is invoked from a context which is not the currently selected applet or the currently 
triggered applet i.e. the context of the applet that treats the current APDU or the context of the applet that has 
been triggered by the current APDU, a java.lang.SecurityException is thrown. 

CRRC2: A reference to this byte array cannot be stored in class variables or instance variables or array 
components. 
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5.4.2.1.2 Test area files 

Test Source: Test_Api_3_Upf_Gvba.java. 
Test Applet; Api_3_Upf_Gvba_l.java. 

Api_S hareablelnterf ace .j ava. 

Api_GetShareableClientApplet.java. 
Cap File: api_3_upf_gvba.cap. 

api_3_upf_gvba2.cap. 



5.4.2.1.3 



Test coverage 



CRR number 


Test case number 


N1 


1 


C1 


2 


C2 


3,4,5 



5.4.2.1.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call getTheVolatileByteArrayO method and 
store it in a local variable 

1- Trigger the applet and check the 
returned byte array length is at least 
equal to 256 bytes. 

2- Select the applet and check the 
returned byte array length is at least 
equal to 256 bytes. 


1- No exception shall be thrown. 

2- No exception shall be thrown. 




2 


Method invoked from a different context 

By the way of the Shareable Interface, 
call the getTheVolatileByteArrayO method 
through another applet. 


A java.lang.SecurityException 
shall be thrown. 




3 


Store the instance in a class variable 


A java.lang.SecurityException 
shall be thrown. 




4 


Store the instance in an instance variable 


A java.lang.SecurityException 
shall be thrown. 




5 


Store the instance in an array component 


A java.lang.SecurityException 
shall be thrown. 
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5.5 CAT Runtime Environment 
5.5.1 IVIinimum Handler Availability 

This test area tests the rules that define the minimum requirements for the availability of the system handlers. 

5.5.1.1 ProactiveHandler 

Test Area Reference: Cre_Mha_Pahd. 

5.5.1 .1 .1 Conformance requirement 

5.5.1.1.1.1 Normal execution 

• CRRNl: If a proactive session is not ongoing the ProactiveHandler is available from the invocation to the 
termination of the processToolkit method for the following events: 

EVENT_MENU_SELECTION 

EVENT_MENU_SELECTION_HELP_REQUEST 

EVENT_TIMER_EXPIRATION 

EVENT_EVENT_DOWNLOAD_MT_CALL 

EVENT_EVENT_DOWNLOAD_CALL_CONNECTED 

EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED 

EVENT_EVENT_DOWNLOAD_LOCATION_STATUS 

EVENT_EVENT_DOWNLOAD_USER_ ACTIVITY 

EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE 

EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS 

EVENT_EVENT_DOWNLOAD_LANGUAGE_SELECTION 

EVENT_EVENT_DOWNLOAD_BROWSER_TERMINATION 

EVENT_UNRECOGNIZED_ENVELOPE 

EVENT_STATUS_COMMAND 

EVENT_CALL_CONTROL_BY_NAA 

EVENT_PROFILE_DOWNLOAD 

EVENT_EVENT_DOWNLOAD_DATA_AVAILABLE 

EVENT_EVENT_DOWNLOAD_CHANNEL_STATUS 

EVENT_EVENT_DOWNLOAD_ACCESS_TECHNOLOGY_CHANGE 

EVENT_EVENT_DOWNLOAD_DISPLAY_PARAMETERS_CHANGED 

EVENT_EVENT_DOWNLOAD_LOCAL_CONNECTION 

EVENT_PROACTIVE_HANDLER_AV AIL ABLE 

EVENT_EVENT_DOWNLOAD_NETWORK_SEARCH_MODE_CHANGE 

EVENT EVENT BROWSING STATUS 
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EVENT_EXTERNAL_FILE_UPDATE 

• CRRN2: A ProactiveHandler is considered available when no HANDLER_NOT_AVAILABLE 
ToolkitException is thrown when the corresponding getTheHandler() method is called or a method of the 
handler is called. 

• CRRN3: When available the ProactiveHandler shall remain available until the termination of the 
processToolkitO method. 

• CRRN4: If a proactive command is pending the ProactiveHandler may not be available. 

5.5.1.1.1.2 Parameter errors 
No requirements. 

5.5.1.1.1.3 Context errors 

• CRRCl: The ProactiveHandler and its content are not available for any toolkit applet triggered from the 
invocation to the termination of their processToolkit method for the following events: 

EVENT_FIRST_COMMAND_AFTER_ATR 

EVENT_APPLICATION_DESELECT 

• CRRC2: The ProactiveHandler shall not be available if the Terminal Profile command has not yet been 
processed by the CAT Runtime Environment 

• CRRC3: The ProactiveHandler shall not be available if the getTheHandler() method is not called, directly or 
indirectly, from the applet's processToolkitQ method. 



5.5.1.1.2 

Test Source: 
Test Applet: 



Cap File: 
5.5.1.1.3 



Test area files 

Test_Cre_Mha_Pahd.j ava. 
Cre_Mha_Pahd_l .Java. 
Cre_Mha_Pahd_2 .j ava. 
Cre_Mha_Pahd_3 .j ava. 
Cre_Mha_Pahd.cap. 

Test coverage 



CRR Number 


Test Case Number 


CRRN1 


2 to 23, 45, 46 


CRRN2 


1 to 22,45,46 


CRRN3 


2 to 22, 45, 46 


CRRN4 


Not testable 


CRRC1 


1,24 


CRRC2 


25 to 44 or also tested in TestCases 25 to 44 in Cre Mha Prhd 


CRRC3 


47 
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5.5.1.1.4 



Test procedure 



Id 



Description 



API /Framework Expectation 



APDU Expectation 



Applets registration to all events and Proactive 

Handler availability with 

EVENT_FIRST_COMMAND_AFTER_ATR 

Appletl is registered to all events 
defined in ETSI TS 102 241 [13] except to 
EVENT_PROACTIVE_HANDLER_AVAILABLE. 
Using the methods initMenuEntry () for 
EVENT_MENU_SELECTION, 
requestPollInterval for 

EVENT_STATUS_COMMAND, allocateTimer ( ) for 
EVENT_T IMER_EXP IRAT I ON , 
allocateServiceldentif ier for 
EVENT_EVENT_DOWNLOAD_LOCAL_CONNECTION and 
setEventList for the rest of the events. 
Appletl is registered on 

EVENT_EXTERNAL_FILE_UPDATE on update of 
EFisHn of the UICC file system 

Applet2 is registered to all events 
defined in ETSI TS 102 241 [13], except to 
EVENT_PROACTIVE_HANDLER_AVAILABLE and 
EVENT_CALL_CONTROL_BY_NAA . 
Using the methods InitMenuEntry ( ) for 
EVENT_MENU_SELECTION, 
requestPollInterval for 

EVENT_STATUS_COMMAND, allocateTimer ( ) for 
EVENT_TIMER_EXPIRATION and setEventList ( ) 
for the rest of the events. 
Applet2 is registered on 

EVENT_EXTERNAL_FILE_UPDATE on update of 
EFtaro of the UICC file system 

The priority of Appletl is higher than 
priority of Applet2 

1- Select MF 



2- Appletl gets the Proactive Handler. 
Appletl is deregistered from 
EVENT_FIRST_COMMAND_AFTER_ATR. 



3- Applet2 gets the Proactive Handler 
Applet2 is deregistered to 
EVENT_FIRST_COMMAND_AFTER_ATR . 



1- Appletl is triggered by 
EVENT_FIRST_COIVIIVIAND_AFTE 
R_ATR 

2- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
tlirown. 

Appletl finalizes 

Applet2 is triggered by 

EVENT_FIRST_COMMAND_AFTE 

R_ATR 

3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown. 

Applet2 finalizes 



Proactive Handler availability with 
EVENT_PROFILE_DOWNLOAD 

1- Terminal Profile command is sent to the 
UICC without the facility of SET UP EVENT 
LIST, POLL INTERVAL, SET UP IDLE MODE TEXT 
and SET UP MENU. 

2- Appletl gets the Proactive Handler 
Appletl is deregistered to 

EVENT PROFILE DOWNLOAD 



3- Applet2 gets the Proactive Handler 
Applet2 is deregistered to 
EVENT PROFILE DOWNLOAD 



1- Appletl is triggered by 
EVENT PROFILE DOWNLOAD 



2- No exception is thrown 
Appletl finalizes. 

Applet2 is triggered by 
EVENT_PROFILE_DOWNLOAD 

3- No exception is thrown 
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Id 
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API /Framework Expectation 


APDU Expectation 






Applet2 finalizes 




3 


Proactive Handler availability with 
EVENT_MENU_SELECTION_HELP_REQUEST 

Perform UICC initialization with all the 
facilities supported, without facility 
SET_UP_EVENT_LIST 

1- Envelope menu selection with help 
request is sent to the UICC 

2- Appletl gets the Proactive Handler 


1- Appletl is triggered 

2- No exception Is thrown 
Appletl finalizes 




4 


Proactive Handler availability with 
EVENT_MENU_SELECTION 

1- Envelope menu selection is sent to the 

UICC 

2- Appletl gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is thrown 
Appletl finalizes 




5 


Proactive Handler availability with 
EVENT_TIMER_EXPIRATION 

1- Timer Id =1 

Envelope Timer Expiration is sent to the 
UICC 

2- Appletl gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is thrown 
Appletl finalizes 




6 


Proactive Handler availability with 
EVENT_CALL_CONTROL_BY_NAA 

1- Envelope call control by NAA is sent to 
the UICC 

2- Appletl gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is thrown 
Appletl finalizes 




7 


Proactive Handler availability with 
EVENT_EVENT_DOWNLOAD_MT_CALL 

1- Envelope event download mt call is sent 
to the UICC 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is thrown 

Appletl finalizes 
Applet2 is triggered 

3-No exception is thrown 

Applet2 finalizes 
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Id 


Description 


API /Framework Expectation 


APDU Expectation 


8 


Proactive Handler availability with 

EVENT EVENT DOWNLOAD CALL CONNECT 

ED 

1- Envelope event download call connected 
is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is tlirown 

Appletl finalizes 
Applet2 is triggered 

3- No exception is thrown 
Applet2 finalizes 




9 


Proactive Handler availability with 

EVENT EVENT DOWNLOAD CALL DISCONN 

ECTED 

1- Envelope event download call 
disconnected is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- No exception Is thrown 

Appletl finalizes 
Applet2 is triggered 

3- No exception is thrown 
Applet2 finalizes 




10 


Applets triggering with 

EVENT EVENT DOWNLOAD LOCATION STA 

TUS 

1- Envelope event download location status 
is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is thrown 

Appletl finalizes 
Applet2 is triggered 

3- No exception is thrown 
Applet2 finalizes 




11 


Proactive Handler availability with 
EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 

1- Envelope event download user activity 
is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is thrown 

Appletl finalizes 
Applet2 is triggered 

3- No exception is thrown 
Applet2 finalizes 
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Id 
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API /Framework Expectation 


APDU Expectation 


12 


Proactive Handler availability with 

EVENT EVENT DOWNLOAD IDLE SCREEN 

AVAILABLE 

1- Envelope event download idle screen 
available is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is thrown 

Appletl finalizes 
Applet2 is triggered 

3- No exception is thrown 
Applet2 finalizes 




13 


Proactive Handler availability with 

EVENT EVENT DOWNLOAD CARD READER 

_STATUS 

1- Envelope event download card reader 
status is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- No exception Is thrown 

Appletl finalizes 
Applet2 is triggered 

3- No exception is thrown 
Applet2 finalizes 




14 


Proactive Handler availability with 

EVENT EVENT DOWNLOAD LANGUAGE SE 

LECTION 

1- Envelope event download language 
selection is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is thrown 

Appletl finalizes 
Applet2 is triggered 

3- No exception is thrown 
Applet2 finalizes 




15 


Proactive Handler availability with 

EVENT EVENT DOWNLOAD BROWSER TER 

MINATION 

1- Envelope event download browser 
termination is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is thrown 

Appletl finalizes 
Applet2 is triggered 

3- No exception is thrown 
Applet2 finalizes 
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Id 
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API /Framework Expectation 


APDU Expectation 


16 


Proactive Handler availability with 
EVENT_STATUS_COMMAND 

1- status command is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is thrown 

Appletl finalizes 
Applet2 is triggered 

3- No exception is thrown 
Applet2 finalizes 




17 


Proactive Handler availability with 

EVENT EVENT DOWNLOAD DATA AVAILAB 

LE 

1- Appletl builds a proactive command OPEN 
CHANNEL proactiveHandler . sendO method is 
called. 

2- An Envelope Event Download Data 
Available is sent to the UICC, with 
channelld=01 . 

3- Appletl gets the Proactive Handler 


2- Appletl is triggered 

3- No exception is thrown 
Appletl finalizes 


1- OPEN CHANNEL 
proactive Command is 
fetched 

TERMINAL RESPONSE is 
issued with Channel Id = 01 


18 


Proactive Handler availability with 

EVENT EVENT DOWNLOAD CHANNEL STAT 

US 

1- An Envelope Event Download Channel 
Status is sent to the UICC, with 
Channelld=01 

2- Appletl gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is thrown 
Appletl finalizes 





ETSI 



Release 6 



531 



ETSI TS 102 268 V6.0.0 (2007-03) 



Id 


Description 


API /Framework Expectation 


APDU Expectation 


19 


Proactive Handler availability with 
UNRECOGNIZED_ENVELOPE 

1- An unrecognized Envelope (BER TLV Tag 
unrecognized) is sent to the UICC 

2- Appletl gets the Proactive Handler 
3-Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is tlirown 

Appletl finalizes 
Applet2 is triggered 

3- No exception is thrown 
Applet2 finalizes 




20 


Proactive Handler availability with 

EVENT EVENT DOWNLOAD ACCESS TECHN 

OLOGY_CHANGE 

1- An envelope event download access 
technology change is sent to the UICC 

2- Appletl gets the Proactive Handler 
3-Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is thrown 

Appletl finalizes 
Applet2 is triggered 

3- No exception is thrown 
Applet2 finalizes 




21 


Proactive Handler availability with 

EVENT EVENT DOWNLOAD DISPLAY PARA 

METERS_CHANGED 

1- An envelope event download display 
parameter changed is sent to the UICC 

2- Appletl gets the Proactive Handler 
4-Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- No exception Is thrown 

3- Appletl sends a DECLARE 
SERVICE (add) proactive 
command with its service identifier 

Appletl finalizes 
Applet2 is triggered 

4- No exception Is thrown 
Applet2 finalizes 


3- DECLARE SERVICE 
(add) proactive command is 
fetched 

Successful 
TERMINAL RESPONSE is 
issued 


22 


Proactive Handler availability with 

EVENT EVENT DOWNLOAD LOCAL CONNE 

CTION 

1- An envelope event download local 
connection is sent to the UICC, with the 
allocated service identifier 

2- Appletl gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is thrown 
Appletl finalizes 
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API /Framework Expectation 


APDU Expectation 


23 


Proactive Handler availability with 
EVENT_PROACTIVE_HANDLER_AVAILABLE 








1- Envelope event download call connected 
is sent to the UICC 


1- Appletl is triggered and registers 

to 

EVENT PROACTIVE HANDLER 

AVAILABLE 

Appletl finalizes 

Applet2 is triggered, registers to 

EVENT_PROACTIVE_HANDLER_ 

AVAILABLE and sends a Display 

Test proactive command 






2-The display Text proactive command is 


2- Appletl is triggered by 






fetch and the terminal response is sent 


EVENT PROACTIVE HANDLER 
AVAILABLE 






3-Appletl gets the Proactive Handler 


3- No exception is thrown 

Appletl finalizes 

Applet2 is triggered by 

EVENT PROACTIVE HANDLER 

AVAILABLE 






4-Applet2 gets the Proactive Handler 


4- No exception is thrown 
Applet2 finalizes 




24 


Proactive Handler availability with 
EVENT_APPLICATION_DESELECT 

1- Select for activation ADFl 








2- Select for termination ADFl 


2- Appletl is triggered 






3- Appletl gets the Proactive Handler 
Appletl deregisters to 


3- A ToolkitException 






EVENT_APPLICATION_DESELECT . 


HANDLER_NOT_AVAILABLE is 
thrown. 

Appletl finalizes 
Applet2 is triggered 






4-Applet2 gets the Proactive Handler 


4- A ToolkitException 






Applet2 deregisters to 


HANDLER_NOT_AVAILABLE is 






EVENT_APPLICATION_DESELECT 


thrown 
Applet2 finalizes 




25 


The ProactiveHandler is not available before 

the Terminal Profile with EVENT MENU 

SELECTION_HELP_REQUEST 

1- Reset the card without sending the 
Terminal Profile 








2- Envelope menu selection with help 
request is sent to the UICC 


2- Appletl is triggered 






3- Appletl gets the Proactive Handler 


3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 
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26 


The ProactiveHandler is not available before 

the Terminal Profile with EVENT MENU 

SELECTION 

1- Envelope menu selection is sent to the 
UICC 

2- Appletl gets the Proactive Handler 


1- Appletl is triggered 

2- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 




27 


The ProactiveHandler is not available before 

the Terminal Profile with 

EVENT_TIMER_EXPIRATION 

1- Timer Id =1 

Envelope Timer Expiration is sent to the 
UICC 

2- Appletl gets the Proactive Handler 


1- Appletl is triggered 

2- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 




28 


The ProactiveHandler is not available before 

the Terminal Profile with 

EVENT_CALL_CONTROL_BY_NAA 

1- Envelope call control by NAA is sent to 
the UICC 

2- Appletl gets the Proactive Handler 


1- Appletl is triggered 

2- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown. 

Appletl finalizes 




29 


The ProactiveHandler is not available before 

the Terminal Profile with 

EVENT_EVENT_DOWNLOAD_MT_CALL 

1- Envelope event download mt call is sent 
to the UICC 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 
Applet2 is triggered 

3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Applet2 finalizes 
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30 


The ProactiveHandler is not available before 

the Terminal Profile with 

EVENT EVENT DOWNLOAD CALL CONNECT 

ED 

1- Envelope event download call connected 
is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 
Applet2 is triggered 

3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Applet2 finalizes 




31 


The ProactiveHandler is not available before 

the Terminal Profile with 

EVENT EVENT DOWNLOAD CALL DISCONN 

ECTED 

1- Envelope event download call 
disconnected is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 
Applet2 is triggered 

3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Applet2 finalizes 




32 


The ProactiveHandler is not available before 

the Terminal Profile with 

EVENT EVENT DOWNLOAD LOCATION STA 

TUS 

1- Envelope event download location status 
is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 
Applet2 is triggered 

3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Applet2 finalizes 
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33 


The ProactiveHandler is not available before 

the Terminal Profile with 
EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 

1- Envelope event download user activity 
is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- A ToolkitException 
HANDLER_NOT_AVAILABLE Is 
thrown 

Appletl finalizes 
Applet2 is triggered 

3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Applet2 finalizes 




34 


The ProactiveHandler is not available before 

the Terminal Profile with 

EVENT EVENT DOWNLOAD IDLE SCREEN 

AVAILABLE 

1- Envelope event download idle screen 
available is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 
Applet2 is triggered 

3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Applet2 finalizes 




35 


The ProactiveHandler is not available before 

the Terminal Profile with 

EVENT EVENT DOWNLOAD CARD READER 

_STATUS 

1- Envelope event download card reader 
status is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 
Applet2 is triggered 

3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Applet2 finalizes 
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36 


The ProactiveHandler is not available before 

the Terminal Profile with 

EVENT EVENT DOWNLOAD LANGUAGE SE 

LECTION 

1- Envelope event download language 
selection is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- A ToolkitException 
HANDLER_NOT_AVAILABLE Is 
thrown 

Appletl finalizes 
Applet2 is triggered 

3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Applet2 finalizes 




37 


The ProactiveHandler is not available before 

the Terminal Profile with 

EVENT EVENT DOWNLOAD BROWSER TER 

MINATION 

1- Envelope event download browser 
termination is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 
Applet2 is triggered 

3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Applet2 finalizes 




38 


The ProactiveHandler is not available before 

the Terminal Profile with 

EVENT_STATUS_COMMAND 

1- status command is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 
Applet2 is triggered 

3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Applet2 finalizes 
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39 


The ProactiveHandler is not available before 

the Terminal Profile with 

UNRECOGNIZED_ENVELOPE 

1- An unrecognized Envelope (BER TLV Tag 
unrecognized) is sent to the UICC 

2- Appletl gets the Proactive Handler 
3-Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- A ToolkitException 
HANDLER_NOT_AVAILABLE Is 
thrown 

Appletl finalizes 
Applet2 is triggered 

3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Applet2 finalizes 




40 


The ProactiveHandler is not available before 

the Terminal Profile with 

EVENT EVENT DOWNLOAD ACCESS TECHN 

OLOGY_CHANGE 

1- An envelope event download access 
technology change is sent to the UICC 

2- Appletl gets the Proactive Handler 
3-Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 
Applet2 is triggered 

3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Applet2 finalizes 




41 


The ProactiveHandler is not available before 

the Terminal Profile with 

EVENT EVENT DOWNLOAD DISPLAY PARA 

METERS_CHANGED 

1- An envelope event download display 
parameter changed is sent to the UICC 

2- Appletl gets the Proactive Handler 
3-Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl registers to 

EVENT PROACTIVE HANDLER 

AVAILABLE then finalizes 

Applet2 is triggered 

3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Applet2 registers to 

EVENT PROACTIVE HANDLER 

AVAILABLE then finalizes 
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42 



The ProactiveHandler is not available before 

the Terminal Profile with 
EVENT PROACTIVE HANDLER AVAILABLE 



Appletl and Applet2 are not 
triggered by 

EVENT_PROACTIVE_HANDLER_ 
AVAILABLE 



43 



The ProactiveHandler is not available before 
the Terminal Profile with 

EVENT_EVENT_DOWNLOAD_NETWORK_SE 
ARCH_MODE_CHANGE 

1- Envelope event download network search 
mode change is sent to the UICC 

2- Appletl gets the Proactive Handler 



3- Applet2 gets the Proactive Handler 



1- Appletl is triggered 



2- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl deregisters from 

EVENT_PROACTIVE_HANDLER_ 

AVAILABLE 

Appletl finalizes 

Applet2 is triggered 

3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Applet2 deregisters from 

EVENT_PROACTIVE_HANDLER_ 

AVAILABLE 



Applet2 finalizes 



44 



The ProactiveHandler is not available before 

the Terminal Profile with 

EVENT_EVENT_DOWNLOAD_BROWSING 

STATUS 

1- Envelope event download browsing status 
is sent to the UICC 

2- Appletl gets the Proactive Handler 



3- Applet2 gets the Proactive Handler 



1- Appletl is triggered 



2- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 
Applet2 is triggered 

3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Applet2 finalizes 
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45 


Proactive Handler availability with 

EVENT EVENT DOWNLOAD NETWORK SE 

ARCH_MODE_CHANGE 

0- Reset card and sendTerminal Profile 
without facility SETUP_EVENT_LIST 

1- Envelope event download network search 
mode change is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is thrown 

Appletl finalizes 
Applet2 is triggered 

3- No exception is thrown 
Applet2 finalizes 




46 


Proactive Handler availability with 

EVENT EVENT DOWNLOAD BROWSING 

STATUS 

1- Envelope event download browsing status 
is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is thrown 

Appletl finalizes 
Applet2 is triggered 

3- No exception Is thrown 
Applet2 finalizes 




47 


The ProactiveHandler Is not available outside 
the processToolkitO method 

1- Install Applet3. In its install method, 
Applet3 gets the ProactiveHandler in a 
Try/Catch session 

2- Select Applet3 

3- Applet3 gets the ProactiveHandler 


1- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

2- Applets is triggered by its 
processO method 

3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 





5.5.1.2 



ProactiveResponseHandler 



Test Area Reference: Cre Mha Prhd. 



5.5.1.2.1 



5.5.1.2.1.1 



Conformance requirement 
Normal execution 



CRRNl: The ProactiveResponseHandler is available as soon as the ProactiveHandler is available and remains 
available untill the termination of the processToolkit method for the following events: 

EVENT_MENU_SELECTION 

EVENT_MENU_SELECTION_HELP_REQUEST 

EVENT TIMER EXPIRATION 
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EVENT_EVENT_DOWNLOAD_MT_CALL 

EVENT_EVENT_DOWNLOAD_CALL_CONNECTED 

EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED 

EVENT_EVENT_DOWNLOAD_LOCATION_STATUS 

EVENT_EVENT_DOWNLOAD_USER_ ACTIVITY 

EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE 

EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS 

EVENT_EVENT_DOWNLOAD_LANGUAGE_SELECTION 

EVENT_EVENT_DOWNLOAD_BROWSER_TERMINATION 

EVENT_UNRECOGNIZED_ENVELOPE 

EVENT_STATUS_COMMAND 

EVENT_CALL_CONTROL_BY_NAA 

EVENT_PROFILE_DOWNLOAD 

EVENT_EVENT_DOWNLOAD_DATA_AVAILABLE 

EVENT_EVENT_DOWNLOAD_CHANNEL_STATUS 

EVENT_EVENT_DOWNLOAD_ACCESS_TECHNOLOGY_CHANGE 

EVENT_EVENT_DOWNLOAD_DISPLAY_PARAMETERS_CHANGED 

EVENT_EVENT_DOWNLOAD_LOCAL_CONNECTION 

EVENT_PROACTIVE_HANDLER_AV AIL ABLE 

EVENT_EVENT_DOWNLOAD_NETWORK_SEARCH_MODE_CHANGE 

EVENT_EVENT_BROWSING_STATUS 

EVENT_EXTERNAL_FILE_UPDATE 

• CRRN2: A ProactiveResponseHandler is considered available when no HANDLER_NOT_AVAILABLE 
ToolkitException is thrown when the corresponding getTheHandler() method is called or a method of the 
handler is called. 

5.5.1.2.1.2 Parameter errors 
No requirements. 

5.5.1 .2.1 .3 Context errors 

• CRRCl: The ProactiveResponseHandler and its content are not available for any toolkit applet triggered from 
the invocation to the termination of their processToolkit method for the following events: 

EVENT_FIRST_COMMAND_AFTER_ATR 

EVENT_APPLICATION_DESELECT 

• CRRC2: The ProactiveResponseHandler shall not be available if the ProactiveHandler is not available. 

• CRRC3: The ProactiveResponseHandler shall not be available if the getTheHandler() method is not called, 
directly or indirectly, from the applet's process TbottifO method. 
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5.5.1.2.2 

Test Source: 
Test Applet: 



Cap File: 
5.5.1.2.3 



Test area files 

Test_Cre_Mha_Prhd.j ava. 
Cre_Mha_Prhd_ 1 .j ava. 
Cre_Mha_Prhd_2.j ava. 
Cre_Mha_Prhd_3 .j ava. 
Cre_Mha_Prhd. cap . 

Test coverage 



CRR Number 


Test Case Number 


CRRN1 


2 to 23, 45, 46 


CRRN2 


1 to 22,45,46 


CRRC1 


1,24 


CRRC2 


25 to 44 


CRRC3 


47 



5.5.1.2.4 



Test procedure 



Id 



Description 



API/CAT RE Expectation 



APDU Expectation 



Applets registration to all events and Proactive 

Handler availability with 

EVENT_FIRST_COMMAND_AFTER_ATR 

Appletl is registered to all events 
defined in ETSI TS 102 241 [13] except to 
EVENT_PROACTIVE_HANDLER_AVAILABLE. 
Using the methods initMenuEntry ( ) for 
EVENT_MENU_SELECTION, 
requestPollInterval ( ) for 

EVENT_STATUS_COMMAND, allocateTimer ( ) for 
EVENT_TIMER_EXPIRATION, 
allocateServiceldentif ier ( ) for 
EVENT_EVENT_DOWNLOAD„LOCAL„CONNECTION and 
setEventList ( ) for the rest of the events. 
Appletl is registered on 

EVENT_EXTERNAL_FILE_UPDATE on update of 
EFTARU of the UICC file system 

Applet2 is registered to all events 
defined in ETSI TS 102 241 [13], except to 
EVENT_PROACTIVE_HANDLER_AVAILABLE and 
EVENT_CALL_CONTROL_BY_NAA . 
Using the methods InitMenuEntry ( ) for 
EVENT_MENU_SELECTION, 
requestPollInterval ( ) for 

EVENT_STATUS_COMMAND, allocateTimer ( ) for 
EVENT_TIMER_EXPIRATION and setEventList ( ) 
for the rest of the events. 
Applet2 is registered on 

EVENT_EXTERNAL_FILE_UPDATE on update of 
EFTARU of the UICC file system 

The priority of Appletl is higher than 
priority of Applet2 

1- Select MF 



2- Appletl gets the Proactive Handler. 



3- Applet2 gets the Proactive Response 
Handler 



1- Appletl is triggered by 
EVENT_FIRST_COI\/ll\/IAND_AFTE 
R_ATR 

2- A Tooll<itException 
HANDLER_NOT_AVAILABLE is 
thrown. 

3- A Tooll<itException 
HANDLER NOT AVAILABLE is 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 




Appletl is deregistered from 
EVENT_F IRST_COMMAND_AFTER_ATR . 

4- Applet2 get the Proactive Handler 

5- Applet2 gets the Proactive Response 
Handler 

Applet2 is deregistered to 
EVENT_F IRST_COMMAND_AFTER_ATR . 


thrown 

Appletl finalizes 

Applet2 is triggered by 

EVENT FIRST COMMAND Ah 1 b 

R_ATR 

4- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown. 

5- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown. 

Applet2 finalizes 




2 


Proactive Handler availability with 
EVENT_PROFILE_DOWNLOAD 

1- Terminal Profile command is sent to the 
UICC without the facility of SET UP EVENT 
LIST, POLL INTERVAL, SET UP IDLE MODE TEXT 
and SET UP MENU. 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 

Appletl is deregistered to 
EVENT_PROF I LE_DOWNLOAD 

4- Applet2 gets the Proactive Handler 
5-Applet2 gets the Proactive Respones 
Handler 

Applet2 is deregistered to 
EVENT_PROFILE_DOWNLOAD 


1- Appletl is triggered by 
EVENT_PROFILE_DOWNLOAD 

2- No exception is thrown 

3- No exception is thrown 
Appletl finalizes. 

Applet2 is triggered by 
EVENT_PROFILE_DOWNLOAD 

4- No exception is thrown 

5- No exception is thrown 

Applet2 finalizes 




3 


Proactive Handler availability with 
EVENT_MENU_SELECTION_HELP_REQUEST 

Perform UICC initialization with all the 
facilities supported, without facility 
SET_UP_EVENT_LIST 

1- Envelope menu selection with help 
request is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 


1- Appletl is triggered 

2- No exception is thrown 

3- No exception is thrown 

Appletl finalizes 




4 


Proactive Handler availability with 
EVENT_MENU_SELECTION 

1- Envelope menu selection is sent to the 
UICC 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 


1- Appletl is triggered 

2- No exception is thrown 

3- No exception is thrown 
Appletl finalizes 




5 


Proactive Handler availability with 
EVENT_TIMER_EXPIRATION 

1- Timer Id =1 

Envelope Timer Expiration is sent to the 
UICC 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 


1 - Appletl is triggered 

2- No exception is thrown 

3- No exception is thrown 
Appletl finalizes 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 




Handler 






6 


Proactive Handler availability with 
EVENT_CALL_CONTROL_BY_NAA 

1- Envelope call control by NAA is sent to 
the UICC 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 


1- Appletl is triggered 

2- No exception is thrown 

3- No exception is thrown 

Appletl finalizes 




7 


Proactive Handler availability with 
EVENT_EVENT_DOWNLOAD_MT_CALL 

1- Envelope event download mt call is sent 
to the UICC 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 

4- Applet2 gets the Proactive Handler 

5- Applet2 gets the Proactive Response 
Handler 


1- Appletl is triggered 

2- No exception is thrown 

3- No exception is thrown 

Appletl finalizes 
Applet2 is triggered 

4-No exception is thrown 
5-No exception is thrown 

Applet2 finalizes 




8 


Proactive Handler availability with 

EVENT EVENT DOWNLOAD CALL CONNECT 

ED 

1- Envelope event download call connected 
is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 

4- Applet2 gets the Proactive Handler 

5- Applet2 gets the Proactive Response 
Handler 


1- Appletl is triggered 

2- No exception is thrown 

3- No exception is thrown 

Appletl finalizes 
Applet2 is triggered 

4- No exception is thrown 
5. No exception is thrown 

Applet2 finalizes 




9 


Proactive Handler availability with 

EVENT EVENT DOWNLOAD CALL DISCONNE 

CTED 

1- Envelope event download call 
disconnected is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 

4- Applet2 gets the Proactive Handler 

5- Applet2 gets the Proactive Response 
Handler 


1- Appletl is triggered 

2- No exception is thrown 

3- No exception is thrown 

Appletl finalizes 
Applet2 Is triggered 

4- No exception is thrown 

5- No exception is thrown 

Applet2 finalizes 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


10 


Applets triggering with 

EVENT EVENT DOWNLOAD LOCATION STAT 

US 

1- Envelope event download location status 
is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 

4- Applet2 gets the Proactive Handler 

5- Applet2 gets the Proactive Response 
Handler 


1- Appletl is triggered 

2- No exception is thrown 

3- No exception is thrown 

Appletl finalizes 
Applet2 is triggered 

4- No exception is thrown 

5- No exception is thrown 

Applet2 finalizes 




11 


Proactive Handler availability with 
EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 

1- Envelope event download user activity 
is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 

4- Applet2 gets the Proactive Handler 

5- Applet2 gets the Proactive Response 
Handler 


1- Appletl is triggered 

2- No exception is thrown 

3- No exception is thrown 

Appletl finalizes 
Applet2 is triggered 

4- No exception is thrown 

5- No exception is thrown 

Applet2 finalizes 




12 


Proactive Response Handler availability with 

EVENT EVENT DOWNLOAD CARD READER 

STATUS 

l-Envelope event download card reader 
status is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 

4- Applet2 gets the Proactive Handler 

5- Applet2 gets the Proactive Response 
Handler 


1- Appletl is triggered 

2- No exception is thrown 

3- No exception is thrown 

Appletl finalizes 
Applet2 is triggered 

4- No exception is thrown 

5- No exception is thrown 
Applet2 finalizes 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


13 


Proactive Handler availability with 

EVENT EVENT DOWNLOAD CARD READER 

STATUS 

1- Envelope event download card reader 
status is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 

4- Applet2 gets the Proactive Handler 

5- Applet2 gets the Proactive Response 
Handler 


1- Appletl is triggered 

2- No exception is thrown 

3- No exception is thrown 

Appletl finalizes 
Applet2 Is triggered 

4- No exception is thrown 

5- No exception is thrown 

Applet2 finalizes 




14 


Proactive Handler availability with 

EVENT EVENT DOWNLOAD LANGUAGE SEL 

ECTION 

1- Envelope event download language 
selection is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 

4- Applet2 gets the Proactive Handler 

5- Applet2 gets the Proactive Response 
Handler 


1- Appletl is triggered 

2- No exception is thrown 

3- No exception is thrown 

Appletl finalizes 
Applet2 is triggered 

4- No exception is thrown 

5- No exception is thrown 

Applet2 finalizes 




15 


Proactive Handler availability with 

EVENT EVENT DOWNLOAD BROWSER TER 

MINATION 

1- Envelope event download browser 
termination is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 

4- Applet2 gets the Proactive Handler 

5- Applet2 gets the Proactive Response 
Handler 


1- Appletl is triggered 

2- No exception is thrown 

3- No exception is thrown 

Appletl finalizes 
Applet2 is triggered 

4- No exception is thrown 

5- No exception is thrown 

Applet2 finalizes 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


16 


Proactive Handler availability with 
EVENT_STATUS_COMMAND 

1- status command is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 

4- Applet2 gets the Proactive Handler 

5- Applet2 gets the Proactive Response 
Handler 


1- Appletl is triggered 

2- No exception is thrown 

3- No exception is thrown 

Appletl finalizes 
Applet2 is triggered 

4- No exception is thrown 

5- No exception is thrown 

Applet2 finalizes 




17 


Proactive Handler availability with 
EVENT EVENT DOWNLOAD DATA AVAILABL 

E 

1- Appletl builds a proactive command OPEN 
CHANNEL proactiveHandler . send ( ) method is 
called. 

2- An Envelope Event Download Data 
Available is sent to the UICC, with 
channelld=01 . 

3- Appletl gets the Proactive Handler 

4- Appletl gets the Proactive Response 
Handler 


2- Appletl is triggered 

3- No exception is thrown 

4- No exception is thrown 

Appletl finalizes 


1- OPEN CHANNEL 
proactive command is 
fetched 

TERMINAL RESPONSE is 
issued with Channel Id = 01 


18 


Proactive Handler availability with 

EVENT EVENT DOWNLOAD CHANNEL STAT 

US 

1- An Envelope Event Download Channel 
Status is sent to the UICC, with 
Channelld=01 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 


1- Appletl is triggered 

2- No exception is thrown 

3- No exception is thrown 

Appletl finalizes 




19 


Proactive Handler availability with 
UNRECOGNIZED_ENVELOPE 

1- An unrecognized Envelope (BER TLV Tag 
unrecognized) is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 

4- Applet2 gets the Proactive Handler 

5- Applet2 gets the Proactive Response 
Handler 


1- Appletl is triggered 

2- No exception is thrown 

3- No exception is thrown 

Appletl finalizes 
Applet2 is triggered 

4- No exception is thrown 

5- No exception is thrown 

Applet2 finalizes 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


20 


Proactive Handler availability with 

EVENT EVENT DOWNLOAD ACCESS TECHN 

OLOGY_CHANGE 

1- An envelope event download access 
technology change is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 

4- Applet2 gets the Proactive Handler 

5- Applet2 gets the Proactive Response 
Handler 


1- Appletl is triggered 

2- No exception is thrown 

3- No exception is thrown 

Appletl finalizes 
Applet2 is triggered 

4- No exception is thrown 

5- No exception is thrown 

Applet2 finalizes 




21 


Proactive Handler availability with 

EVENT EVENT DOWNLOAD DISPLAY PARAM 

ETERS_CHANGED 

1- An envelope event download display 
parameter changed is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 

5- Applet2 gets the Proactive Handler 

6- Applet2 gets the Proactive Response 
Handler 


1- Appletl is triggered 

2- No exception is thrown 

3- No exception is thrown 

4- Appletl sends a DECLARE 
SERVICE (add) proactive 
command with its service identifier 

Appletl finalizes 
Applet2 is triggered 

5- No exception is thrown 

6- No exception is thrown 

Applet2 finalizes 


4- DECLARE SERVICE 
(add) proactive command is 
fetched 

Successful TERMINAL 
RESPONSE is issued 


22 


Proactive Handler availability with 

EVENT EVENT DOWNLOAD LOCAL CONNEC 

TION 

1- An envelope event download local 
connection is sent to the UICC, with the 
allocated service identifier 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 


1- Appletl is triggered 

2- No exception is thrown 

3- No exception is thrown 

Appletl finalizes 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


23 


Proactive Handler availability with 
EVENT_PROACTIVE_HANDLER_AVAILABLE 








1- Envelope event download call connected 
is sent to the UICC 


1 - Appletl is triggered and registers 

to 

EVENT PROACTIVE HANDLER 

AVAILABLE 






2- The display Text proactive command is 
fetch and the terminal response is sent 

3- Appletl gets the Proactive Handler 

4- Appletl gets the Proactive Response 


Appletl finalizes 

Applet2 is triggered, registers to 

EVENT_PROACTIVE_HANDLER_ 

AVAILABLE and sends a Display 

Test proactive command 

2- Appletl is triggered by 
EVENT PROACTIVE HANDLER 
AVAILABLE 






Handler 


3- No exception is thrown 

4- No exception is thrown 






5- Applet2 gets the Proactive Handler 

6- Applet2 gets the Proactive Response 


Appletl finalizes 

Applet2 is triggered by 

EVENT PROACTIVE HANDLER 

AVAILABLE 






Handler 


4- No exception is thrown 

5- No exception is thrown 

Applet2 finalizes 




24 


Proactive Handler availability with 
EVENT_APPLICATION_DESELECT 

1- Select for activation ADFl 








2- Select for termination ADFl 


2- Appletl is triggered 






3- Appletl gets the Proactive Handler 

4- Appletl gets the Proactive Response 
Handler 

Appletl deregisters to 
EVENT_APPLICATION_DESELECT . 


3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown. 

4- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 
Applet2 is triggered 






5-Applet2 gets the Proactive Handler 


5- A ToolkitException 
HANDLER_NOT_AVAILABLE is 






6-Applet2 gets the Proactive Response 
Handler 


thrown 

6- A ToolkitException 

HANDLER_NOT_AVAILABLE is 

thrown 






Applet2 deregisters to 

EVENT_APPLICATION_DESELECT. 


Applet2 finalizes 
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APDU Expectation 


25 


The ProactiveHandler is not available before the 

Terminal Profile with EVENT MENU 

SELECTION_HELP_REQUEST 

1- Reset the card without sending the 
Terminal Profile 

2- Envelope menu selection with help 
request is sent to the UICC 

3- Appletl gets the Proactive Handler 

4- Appletl gets the Proactive Response 
Handler 


2- Appletl is triggered 

3- A Tooll<itException 
HANDLER_NOT_AVAILABLE is 
thrown 

4- A Tooll<itException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 




26 


The ProactiveHandler is not available before the 

Terminal Profile with EVENT MENU 

SELECTION 

1- Envelope menu selection is sent to the 
UICC 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 


1- Appletl is triggered 

2- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown. 

3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 




27 


The ProactiveHandler is not available before the 

Terminal Profile with 

EVENT_TIMER_EXPIRATION 

1- Timer Id =1 

Envelope Timer Expiration is sent to the 
UICC 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 


1- Appletl is triggered 

2- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown. 

3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 




28 


The ProactiveHandler is not available before the 

Terminal Profile with 

EVENT_CALL_CONTROL_BY_NAA 

1- Envelope call control by NAA is sent to 
the UICC 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 


1- Appletl is triggered 

2- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown. 

3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 





ETSI 



Release 6 



550 



ETSI TS 102 268 V6.0.0 (2007-03) 



Id 


Description 
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APDU Expectation 


29 


The ProactiveHandler is not available before the 

Terminal Profile with 

EVENT_EVENT_DOWNLOAD_MT_CALL 

1- Envelope event download mt call is sent 

to the UICC 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 

4- Applet2 gets the Proactive Handler 

5- Applet2 gets the Proactive Response 
Handler 


1- Appletl is triggered 

2- A Tooll<itException 
HANDLER_NOT_AVAILABLE is 
thrown 

3- A Tooll<itException 
HANDLER_NOT_AVAILABLE is 
thrown. 

Appletl finalizes 
Applet2 is triggered 

4- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

5-A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Applet2 finalizes 




30 


The ProactiveHandler is not available before the 

Terminal Profile with 

EVENT EVENT DOWNLOAD CALL CONNECT 

ED 

1- Envelope event download call connected 
is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 

4- Applet2 gets the Proactive Handler 

5- Applet2 gets the Proactive Response 
Handler 


1- Appletl is triggered 

2- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 
Applet2 is triggered 

4- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

5-A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Applet2 finalizes 
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31 


The ProactiveHandler is not available before the 

Terminal Profile with 

EVENT EVENT DOWNLOAD CALL DISCONNE 

CTED 

1- Envelope event download call 
disconnected is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 

4- Applet2 gets the Proactive Handler 

5- Applet2 gets the Proactive Response 
Handler 


1 - Appletl is triggered 

2- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

3- A Tooll<itException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 
Applet2 is triggered 

4- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

5-A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Applet2 finalizes 




32 


The ProactiveHandler is not available before the 

Terminal Profile with 

EVENT EVENT DOWNLOAD LOCATION STAT 

US 

1- Envelope event download location status 
is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 

4- Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 
Applet2 is triggered 

4- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

5- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Applet2 finalizes 
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33 


The ProactiveHandler is not available before the 

Terminal Profile with 
EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 

1- Envelope event download user activity 
is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 

4- Applet2 gets the Proactive Handler 

5- Applet2 gets the Proactive Response 
Handler 


1- Appletl is triggered 

2- A Tooll<itException 
HANDLER_NOT_AVAILABLE is 
thrown 

3- A Tooll<itException 
HANDLER_NOT_AVAILABLE is 
thrown. 

Appletl finalizes 
Applet2 is triggered 

4- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

5-A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Applet2 finalizes 




34 


The ProactiveHandler is not available before the 

Terminal Profile with 

EVENT EVENT DOWNLOAD IDLE SCREEN A 

VAILABLE 

1- Envelope event download idle screen 
available is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 

4- Applet2 gets the Proactive Handler 

5- Applet2 gets the Proactive Response 
Handler 


1- Appletl is triggered 

2- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 
Applet2 is triggered 

4- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

5- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown. 

Applet2 finalizes 
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35 


The ProactiveHandler is not available before the 

Terminal Profile with 

EVENT EVENT DOWNLOAD CARD READER 

STATUS 

1- Envelope event download card reader 
status is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 

4- Applet2 gets the Proactive Handler 

5- Applet2 gets the Proactive Response 
Handler 


1- Appletl is triggered 

2- A Tooll<itException 

HANDLER_NOT_AVAILABLE is 

thrown 

3-A ToolkitException 

HANDLER_NOT_AVAILABLE is 

thrown. 

Appletl finalizes 
Applet2 is triggered 

4- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

5- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown. 

Applet2 finalizes 




36 


The ProactiveHandler is not available before the 

Terminal Profile with 

EVENT EVENT DOWNLOAD LANGUAGE SEL 

ECTION 

1- Envelope event download language 
selection is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 

4- Applet2 gets the Proactive Handler 

5- Applet2 gets the Proactive Response 
Handler 


1- Appletl is triggered 

2- A ToolkitException 

HANDLER_NOT_AVAILABLE is 

thrown 

3--A ToolkitException 

HANDLER_NOT_AVAILABLE is 

thrown. 

Appletl finalizes 
Applet2 is triggered 

4- A ToolkitException 

HANDLER_NOT_AVAILABLE is 

thrown 

5-A ToolkitException 

HANDLER_NOT_AVAILABLE is 

thrown. 

Applet2 finalizes 




37 


The ProactiveHandler is not available before the 

Terminal Profile with 

EVENT EVENT DOWNLOAD BROWSER TER 

MINATION 

1- Envelope event download browser 
termination is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 
Applet2 is triggered 
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3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Applet2 finalizes 




38 


The ProactiveHandler is not available before the 

Terminal Profile with 

EVENT_STATUS_COMMAND 

1- status command is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 

4- Applet2 gets the Proactive Handler 

5- Applet2 gets the Proactive Response 
Handler 


1- Appletl is triggered 

2- A ToolkitException 

HANDLER_NOT_AVAILABLE is 

thrown 

3-A ToolkitException 

HANDLER_NOT_AVAILABLE is 

thrown. 

Appletl finalizes 
Applet2 is triggered 

4- A ToolkitException 

HANDLER_NOT_AVAILABLE is 

thrown 

5A ToolkitException 

HANDLER_NOT_AVAILABLE is 

thrown. 

Applet2 finalizes 




39 


The ProactiveHandler is not available before the 

Terminal Profile with 

UNRECOGNIZED_ENVELOPE 

1- An unrecognized Envelope (BER TLV Tag 
unrecognized) is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 

4- Applet2 gets the Proactive Handler 

5- Applet2 gets the Proactive Response 
Handler 


1- Appletl is triggered 

2- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown. 

Appletl finalizes 
Applet2 is triggered 

4- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

5- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown. 

Applet2 finalizes 
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40 


The ProactiveHandler is not available before the 

Terminal Profile with 

EVENT EVENT DOWNLOAD ACCESS TECHN 

OLOGY_CHANGE 

1- An envelope event download access 
technology change is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 

4- Applet2 gets the Proactive Handler 

5- Applet2 gets the Proactive Response 
Handler 


1- Appletl is triggered 

2- A Tooll<itException 

HANDLER_NOT_AVAILABLE is 

thrown 

3-A ToolkitException 

HANDLER_NOT_AVAILABLE is 

thrown. 

Appletl finalizes 
Applet2 is triggered 

4- A ToolkitException 

HANDLER_NOT_AVAILABLE is 

thrown 

5-A ToolkitException 

HANDLER_NOT_AVAILABLE is 

thrown. 

Applet2 finalizes 




41 


The ProactiveHandler is not available before the 

Terminal Profile with 

EVENT EVENT DOWNLOAD DISPLAY PARAM 

ETERS_CHANGED 

1- An envelope event download display 
parameter changed is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 

4- Applet2 gets the Proactive Handler 

5- Applet2 gets the Proactive Response 
Handler 


1- Appletl is triggered 

2- A ToolkitException 

HANDLER_NOT_AVAILABLE is 

thrown 

3-A ToolkitException 

HANDLER_NOT_AVAILABLE is 

thrown. 

Appletl registers to 

EVENT PROACTIVE HANDLER 

AVAILABLE then finalizes 

Applet2 is triggered 

4- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

5- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown. 

Applet2 registers to 

EVENT PROACTIVE HANDLER 

AVAILABLE then finalizes 




42 


The ProactiveHandler is not available before the 

Terminal Profile with 

EVENT_PROACTIVE_HANDLER_AVAILABLE 


Appletl and Applet2 are not 

triggered by 

EVENT PROACTIVE HANDLER 

AVAILABLE 
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43 



The ProactiveHandler is not available before 
the Terminal Profile with 

EVENT_EVENT_DOWNLOAD_NETWORK_SE 
ARCH_MODE_CHANGE 

1- Envelope event download network search 
mode change is sent to the UICC 

2- Appletl gets the Proactive Handler 



3- Appletl gets the Proactive Response 
Handler 



4- Applet2 gets the Proactive Handler 



5- Applet2 gets the Proactive Response 
Handler 



1- Appletl is triggered 



2- A Tooll<itException 
HANDLER_NOT_AVAILABLE is 
thrown 

3- A Tooll<itException 
HANDLER_NOT_AVAILABLE is 
thrown. 

Appletl deregisters from 

EVENT_PROACTIVE_HANDLER_ 

AVAILABLE 

Appletl finalizes 

Applet2 is triggered 

4- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

5- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown. 

Applet2 deregisters from 

EVENT_PROACTIVE_HANDLER_ 

AVAILABLE 



Applet2 finalizes 



44 



The ProactiveHandler is not available before the 

Terminal Profile with 

EVENT_EVENT_DOWNLOAD_BROWSING 

STATUS 

1- Envelope event download browsing status 
is sent to the UICC 

2- Appletl gets the Proactive Handler 



3- Appletl gets the Proactive Response 
Handler 



4- Applet2 gets the Proactive Handler 



5- Applet2 gets the Proactive Response 
Handler 



1- Appletl is triggered 



2- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown. 

Appletl finalizes 
Applet2 is triggered 

4- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

5- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown. 

Applet2 finalizes 
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45 


Proactive Handler availability with 

EVENT EVENT DOWNLOAD NETWORK SEAR 

CH_MODE_CHANGE 

0- Reset card and sendTerminal Profile 
without facility SETUP_EVENT_LIST 

1- Envelope event download network search 
mode change is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 

4- Applet2 gets the Proactive Handler 

5- Applet2 gets the Proactive Response 
Handler 


1- Appletl is triggered 

2- No exception is thrown 

3- No exception is thrown 

Appletl finalizes 
Applet2 is triggered 

4- No exception is thrown 

5- No exception is thrown 

Applet2 finalizes 




46 


Proactive Handler availability with 

EVENT EVENT DOWNLOAD BROWSING 

STATUS 

1- Envelope event download browsing status 
is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 

4- Applet2 gets the Proactive Handler 

5- Applet2 gets the Proactive Response 
Handler 


1- Appletl is triggered 

2- No exception is thrown 

3- No exception is thrown 

Appletl finalizes 
Applet2 is triggered 

4- No exception is thrown 

5- No exception is thrown 

Applet2 finalizes 




47 


The ProactiveHandler is not available outside 
the processToolkitO method 

1- Install Applet3. In its install method, 
Applet3 gets the Proactive Handler and the 
Proactive Response Handler in a Try/Catch 
session 

2- Select Applet3 

3- Applet3 gets the ProactiveHandler and 
the Proactive Response Handler. 


1 - A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

2- Applet3 is triggered by its 
processO method 

3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 





5.5.1.3 EnvelopeHandler 

Test Area Reference: Cre_Mha_Enhd. 



5.5.1.3.1 



5.5.1.3.1.1 



Conformance requirement 
Normal execution 



CRRN 1 : The EnvelopeHandler and its content are available for all toolkit applets triggered from the 
invocation to the termination of their processToolkit method for the following events: 

EVENT MENU SELECTION 
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EVENT_MENU_SELECTION_HELP_REQUEST 

EVENT_TIMER_EXPIRATION 

EVENT_EVENT_DOWNLOAD_MT_CALL 

EVENT_EVENT_DOWNLOAD_CALL_CONNECTED 

EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED 

EVENT_EVENT_DOWNLOAD_LOCATION_STATUS 

EVENT_EVENT_DOWNLOAD_USER_ ACTIVITY 

EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE 

EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS 

EVENT_EVENT_DOWNLOAD_LANGUAGE_SELECTION 

EVENT_EVENT_DOWNLOAD_BROWSER_TERMINATION 

EVENT_UNRECOGNIZED_ENVELOPE 

EVENT_CALL_CONTROL_BY_NAA 

EVENT_EVENT_DOWNLOAD_DATA_AVAILABLE 

EVENT_EVENT_DOWNLOAD_CHANNEL_STATUS 

EVENT_EVENT_DOWNLOAD_ACCESS_TECHNOLOGY_CHANGE 

EVENT_EVENT_DOWNLOAD_DISPLAY_PARAMETERS_CHANGED 

EVENT_EVENT_DOWNLOAD_LOCAL_CONNECTION 

EVENT_APPLICATION_DESELECT 

EVENT_EVENT_DOWNLOAD_NETWORK_SEARCH_MODE_CHANGE 

EVENT_EVENT_BROWSING_STATUS 

EVENT_EXTERNAL_FILE_UPDATE 

• CRRN2: An EnvelopeHandler is considered available when no HANDLER_NOT_A VAIL ABLE 

ToolkitException is thrown when the corresponding getTheHandler() method is called or a method of the 
handler is called. 

5.5.1.3.1.2 Parameter errors 
No requirements. 

5.5.1 .3.1 .3 Context errors 



• 



• 



CRRCl: The EnvelopeHandler and its content are not available for any toolkit applet triggered from the 
invocation to the termination of their processToolkit method for the following events: 

EVENT_STATUS_COMMAND 

EVENT_PROFILE_DOWNLOAD 

EVENT_FIRST_COMMAND_AFTER_ATR 

EVENT_PROACTIVE_HANDLER_AVAILABLE 

CRRC2: The EnvelopeHandler shall not be available if the getTheHandler() method is not called, directly or 
indirectly, from the applet's processToolkit{) method. 
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5.5.1.3.2 

Test Source: 
Test Applet: 



Cap File : 
5.5.1.3.3 



Test area files 

Test_Cre_Mha_Enhd.j ava. 
Cre_Mha_Enhd_ 1 .j a va . 
Cre_Mha_Enhd_2.j ava. 
Cre_Mha_Enhd_3 .j ava. 
Cre_Mha_Enhd.cap. 

Test coverage 



CRR Number 


Test Case Number 


CRRN1 


3,4,5,6,7,8,9, 10, 11, 12, 13, 14, 15, 17, 18, 19,20,22,24,26,27,28,29 


CRRN2 


1 to 24, 26, 27, 28, 29 


CRRC1 


1,2, 16,23 


CRRC2 


25 
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5.5.1.3.4 



Test procedure 



Id 



Description 



API/CAT RE Expectation 



APDU Expectation 



Appletl and Applet2 registration and Envelope 

Handler availability with 

EVENT_FIRST_COMMAND_AFTER_ATR 

1- Appletl is registered to all events 
defined ETSI TS 102 241 [13] except to 
EVENT_PROACTIVE_HANDLER_AVAILABLE. 

The registration is done using the methods 
initMenuEntry for EVENT_MENU_SELECTION, 
requestPollInterval for 

EVENT_STATUS_COMMAND, allocateTimer ( ) for 
EVENT_T IMER_EXP IRAT I ON , 
allocateServiceldentif ier for 
EVENT_EVENT_DOWNLOAD_LOCAL_CONNECTION and 
setEventList for the rest of the events. 
Appletl is registered on 

EVENT_EXTERNAL_FILE_UPDATE on update of 
EFisHn of the UICC file system 

Applet2 is registered to all events 
defined ETSI TS 102 241 [13] except to 
EVENT_PROACTIVE_HANDLER_AVAILABLE and 
EVENT_CALL_CONTROL_BY_NAA . 

The registration is done using the methods 
initMenuEntry for EVENT_MENU_SELECTION, 
requestPollInterval for 

EVENT_STATUS_COMMAND, allocateTimer for 
EVENT_TIMER_EXPIRATION and setEventList 
for the rest of the events. 
Applet2 is registered on 

EVENT_EXTERNAL_FILE_UPDATE on update of 
EFtaro of the UICC file system 

2- Select MF . 



3- EnvelopeHandler . getTheHandler ( ) method 
is called by Appletl 
Appletl is deregistered from 
EVENT_FIRST_COMMAND_AFTER_ATR. 



4- EnvelopeHandler . getTheHandler ( ) method 
is called by Applet2 
Applet2 is deregistered to 
EVENT_FIRST_COMMAND_AFTER_ATR. 



1- No exception Is thrown 



2- Appletl is triggered by 
EVENT_FIRST_COIVIIVIAND_AFTE 
R_ATR 

3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
tlirown 

Appletl finalizes 
Applet2 is triggered 

4- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 



Applet2 finalizes 



Handler availability with 
EVENT_PROFILE_DOWNLOAD 

1- Terminal Profile command is sent to the 
UICC without the facility of 
SET_EVENT_LIST, SETUP_IDLE_MODE_TEXT, 
POLL_INTERVAL and SETUP MENU 

2- EnvelopeHandler . getTheHandler ( ) method 
is called by Appletl 

Appletl is deregistered to 
EVENT_PROF I LE_DOWNLOAD 



3- EnvelopeHandler .getTheHandler method 
is called by Applet2 
Applet2 is deregistered to 
EVENT_PROFILE_DOWNLOAD 



1- Appletl is triggered by 
EVENT PROFILE DOWNLOAD 



2- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 

Applet2 is triggered by 

EVENT_PROFILE_DOWNLOAD 

3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Applet2 finalizes 
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3 


Envelope Handler availability with 
EVENT_MENU_SELECTION_HELP_REQUEST 

Perform UICC initialization with all the 
facilities supported 

1- Envelope menu selection with help 
request is sent to the UICC 

2- EnvelopeHandler .getTheHandler method 
is called by Appletl 


1- Appletl is triggered 
2- No exception is tlirown 
Appletl finalizes 




4 


Envelope Handler availability with 
EVENT_MENU_SELECTION 

1- Envelope menu selection is sent to the 

UICC 

2- EnvelopeHandler .getTheHandler method 
is called by Appletl 


1- Appletl is triggered 

2- No exception is thrown 
Appletl finalizes 




5 


Envelope Handler availability with 
EVENT_TIMER_EXPIRATION 

Timer id=l 

1- Envelope Timer Expiration is sent to 
the UICC 

2- EnvelopeHandler .getTheHandler method 
is called by Appletl 


1- Appletl is triggered 
2- No exception is thrown 

Appletl finalizes 




6 


Envelope Handler availability with 
EVENT_CALL_CONTROL_BY_NAA 

1- Envelope call control by NAA is sent to 
the UICC 

2- EnvelopeHandler .getTheHandler method 
is called by Appletl 


1- Appletl is triggered 

2- No exception Is thrown 
Appletl finalizes 




7 


Envelope Handler availability with 
EVENT_EVENT_DOWNLOAD_MT_CALL 

1- Envelope event download mt call is sent 
to the UICC 

2- EnvelopeHandler . getTheHandler ( ) method 
is called by Appletl 

3- EnvelopeHandler .getTheHandler method 
is called by Applet2 


1- Appletl is triggered 

2- No exception is thrown 

Appletl finalizes 
Applet2 is triggered 

3- No exception is thrown 
Applet2 finalizes 




8 


Envelope Handler availability with 

EVENT EVENT DOWNLOAD CALL CONNECT 

ED 

1- Envelope event download call connected 
is sent to the UICC 

2- EnvelopeHandler . getTheHandler ( ) method 
is called by Appletl 

3- EnvelopeHandler .getTheHandler method 
is called by Applet2 


1- Appletl is triggered 

2- No exception is thrown 

Appletl finalizes 
Applet2 is triggered 

3- No exception is thrown 
Applet2 finalizes 
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9 


Envelope Handler availability with 

EVENT EVENT DOWNLOAD CALL DISCONE 

CTTED 

1- Envelope event download call 
disconnected is sent to the UICC 

2- EnvelopeHandler .getTheHandler {) method 
is called by Appletl 

3- EnvelopeHandler . getTheHandler ( ) method 
is called by Applet2 


1- Appletl is triggered. 

2- No exception is tlirown 

Appletl finalizes 
Applet2 is triggered 

3- No exception is thrown 
Applet2 finalizes 




10 


Envelope Handler availability with 

EVENT EVENT DOWNLOAD LOCATION STA 

TUS 

1- Envelope event download location status 
is sent to the UICC 

2- EnvelopeHandler .getTheHandler method 
is called by Appletl 

3- EnvelopeHandler . getTheHandler ( ) method 
is called by Applet2 


1- Appletl is triggered 

2- No exception Is thrown 

Appletl finalizes 
Applet2 is triggered 

3- No exception Is thrown 
Applet2 finalizes 




11 


Envelope Handler availability with 
EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 

1- Envelope event download user activity 
is sent to the UICC 

2- EnvelopeHandler .getTheHandler {) method 
is called by Appletl 

3- EnvelopeHandler . getTheHandler ( ) method 
is called by Applet2 


1- Appletl is triggered 

2- No exception is thrown 
Appletl finalizes 
Applet2 is triggered 

3- No exception is thrown 
Applet2 finalizes 




12 


Envelope Handler availability with 

EVENT EVENT DOWNLOAD IDLE SCREEN 

AVAILABLE 

1- Envelope event download idle screen 
available is sent to the UICC 

2- EnvelopeHandler . getTheHandler ( ) method 
is called by Appletl 

3- EnvelopeHandler .getTheHandler method 
is called by Applet2 


1- Appletl is triggered 

2- No exception is thrown 
Appletl finalizes 
Applet2 is triggered 

3- No exception is thrown 
Applet2 finalizes 




13 


Envelope Handler availability with 

EVENT EVENT DOWNLOAD CARD READER 

_STATUS 

1- Envelope event download card reader 
status is sent to the UICC 

2- EnvelopeHandler . getTheHandler ( ) method 
is called by Appletl 

3- EnvelopeHandler . getTheHandler ( ) method 
is called by Applet2 


1- Appletl is triggered 

2- No exception is thrown 

Appletl finalizes 
Applet2 is triggered 

3- No exception Is thrown 
Applet2 finalizes 
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14 


Envelope Handler availability with 

EVENT EVENT DOWNLOAD LANGUAGE 

SELECTION 

1- Envelope event download language 
selection is sent to the UICC 

2- EnvelopeHandler .getTheHandler {) method 
is called by Appletl 

3- EnvelopeHandler . getTheHandler ( ) method 
is called by Applet2 


1- Appletl is triggered 

2- No exception is tlirown 

Appletl finalizes 
Applet2 is triggered 

3- No exception is thrown 
Applet2 finalizes 




15 


Envelope Handler availability with 

EVENT EVENT DOWNLOAD BROWSER 

TERMINATION 

1- Envelope event download browser 
termination is sent to the UICC 

2- EnvelopeHandler .getTheHandler method 
is called by Appletl 

3- EnvelopeHandler . getTheHandler ( ) method 
is called by Applet2 


1- Appletl is triggered 

2- No exception is thrown 

Appletl finalizes 
Applet2 is triggered 

3- No exception is thrown 
Applet2 finalizes 




16 


Envelope Handler availability with 
EVENT_STATUS_COMMAND 

1- status command is sent to the UICC 

2- EnvelopeHandler . getTheHandler ( ) method 
is called by Appletl 

3- EnvelopeHandler .getTheHandler method 
is called by Applet2 


1- Appletl is triggered 

2- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 
Applet2 is triggered 

3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Applet2 finalizes 




17 


Envelope Handler availability with 

EVENT EVENT DOWNLOAD DATA AVAILAB 

LE 

1- Appletl builds a proactive command OPEN 
CHANNEL . 

proactiveHandler . send ( ) method is called 

2- Envelope event download data available 
is sent to the UICC with Channelld=01 . 

3- EnvelopeHandler . getTheHandler ( ) method 

is called by Appletl 


1- Appletl is registered to 
EVENT EVENT DOWNLOAD DA 
TA AVAILABLE and 

EVENT EVENT DOWNLOAD CH 
ANNEL_STATUS 

2- Appletl is triggered 

3- No exception is thrown 
Appletl finalizes 


1- OPEN CHANNEL 
proactive command is 
fetched 

TERMINAL RESPONSE is 
issued with Channel Id = 01 
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18 


Envelope Handler availability with 

EVENT EVENT DOWNLOAD CHANNEL STAT 

US 

1- Envelope event download channel status 
is sent to the UICC with Channelld=01 . 

2- EnvelopeHandler .getTheHandler method 
is called by Appletl 


1- Appletl is triggered 

2- No exception is thrown 
Appletl finalizes 




19 


Envelope Handler availability with EVENT 
UNRECOGNIZED_ENVELOPE 

1- An unrecognized Envelope is sent to the 
UICC 

2- EnvelopeHandler . getTheHandler ( ) method 
is called by Appletl 

4- EnvelopeHandler .getTheHandler method 
is called by Applet2 


1- Appletl is triggered 

2- No exception is thrown 

3- Appletl sends a DECLARE 
SERVICE (add) proactive 
command with its service identifier 

Appletl finalizes 
Applet2 is triggered 

4- No exception is thrown 
Applet2 finalizes 


3- DECLARE SERVICE 
(add) proactive command is 
fetched 

Successful TERMINAL 
RESPONSE is issued 


20 


Envelope Handler availability with 

EVENT EVENT DOWNLOAD LOCAL CONNE 

CTION 

1- Envelope event download local 
connection is sent to the UICC with the 
allocated service Id of Appletl 

2- EnvelopeHandler .getTheHandler method 
is called by Appletl 


1- Appletl is triggered 

2- No exception is thrown 
Appletl finalizes 




21 


Envelope Handler availability with 

EVENT EVENT DOWNLOAD ACCESS TECHN 

OLOGY_CHANGE 

1- Envelope event download access 
technology change is sent to the UICC 

2- EnvelopeHandler .getTheHandler method 
is called by Appletl 

3- EnvelopeHandler .getTheHandler method 
is called by Applet2 


1- Appletl is triggered 

2- No exception is thrown 
Appletl finalizes 
Applet2 is triggered 

3- No exception is thrown 
Applet2 finalizes 




22 


Envelope Handler availability with 

EVENT EVENT DOWNLOAD DISPLAY PARA 

METERS_CHANGED 

1- Envelope event display parameter 
changed is sent to the UICC 

2- EnvelopeHandler .getTheHandler method 
is called by Appletl 

3- EnvelopeHandler .getTheHandler method 
is called by Applet2 


1- Appletl is triggered and registers 
to 

EVENT PROACTIVE HANDLER 
AVAILABLE 

2- No exception is thrown 
Appletl finalizes 

Applet2 is triggered and registers to 
EVENT PROACTIVE HANDLER 
AVAILABLE 

3- No exception is thrown 
Applet2 finalizes 
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23 


Envelope Handler availability with 
EVENT_PROACTIVE_HANDLER_AVAILABLE 

2- EnvelopeHandler . getTheHandler ( ) method 
is called by Appletl 

3- EnvelopeHandler . getTheHandler ( ) method 
is called by Applet2 


1- Appletl is triggered by 
EVENT PROACTIVE HANDLER 
AVAILABLE 

2- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 

Applet2 is triggered by 

EVENT PROACTIVE HANDLER 

AVAILABLE 

3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Applet2 finalizes 




24 


Envelope Handler availability with 
EVENT_APPLICATION_DESELECT 

1- Select for activation ADFl 

2- Select for termination ADFl 

3- EnvelopeHandler .getTheHandler method 
is called by Appletl. 

Appletl deregisters to 
EVENT_APPLICATION_DESELECT . 

4- EnvelopeHandler . getTheHandler ( ) method 
is called by Applet2 . 

Appletl deregisters to 
EVENT_APPLICATION_DESELECT . 


2- Appletl is triggered 

3- No exception is thrown 

Appletl finalizes 
Applet2 is triggered 

4- No exception Is thrown 
Applet2 finalizes 




25 


Envelope Handler availability with 

EVENT EVENT DOWNLOAD NETWORK SEA 

RCH_MODE_CHANGE 

1 - Envelope event download network search mode 
change is sent to the UICC 

2- EnvelopeHandler.getlheHandlerQ method is 
called by Appletl 

3- EnvelopeHandler.getlheHandlerQ method is 
called by Applet2 


1- Appletl is triggered 

2- No exception is thrown 

Appletl finalizes 
Applet2 is triggered 

3- No exception is thrown 
Applet2 finalizes 




26 


Envelope Handler availability with 
EVENT_EVENT_BROWSING_STATUS 

1- Envelope event download browsing status 
is sent to the UICC 

2- EnvelopeHandler . getTheHandler ( ) method 
is called by Appletl 

3- EnvelopeHandler .getTheHandler method 
is called by Applet2 


1- Appletl is triggered 

2- No exception is thrown 
Appletl finalizes 
Applet2 is triggered 

3- No exception is thrown 
Applet2 finalizes 
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The EnvelopeHandler is not available outside 
the processToolkitQ method 

1- Install Applets. In its install method, 
Applets gets the EnvelopeHandler in a 
Try/Catch session 

2- Select Applets 

3- Applets gets the EnvelopeHandler 


1- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

2- Applets is triggered by its 
processO method 

3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 





5.5.1.4 EnvelopeResponseHandler 

Test Area Reference: Cre_Mha_Erhd 



5.5.1.4.1 



5.5.1.4.1.1 



Conformance requirement 



Normal execution 



• CRRNl: The handler is available for all triggered toolkit applets from the invocation of the processToolkit 
method of the toolkit applet until a toolkit applet has posted an envelope response or the first invocation of the 
ProactiveHandler.send method for the following events: 

EVENT_CALL_CONTROL_BY_NAA 

EVENT_UNRECOGNIZED_ENVELOPE 

• CRRN2: After a call to the post method the handler is not longer available. 

• CRRN3: After a call to the send method the handler is not longer available. 

• CRRN4: An EnvelopeResponseHandler is considered available when no HANDLER_NOT_AVAILABLE 
ToolkitException is thrown when the corresponding getTheHandler() method is called or a method of the 
handler is called. 

5.5.1.4.1.2 Parameter errors 
No requirements. 

5.5.1 .4.1 .3 Context errors 

• CRRCl: The handler is not available for the following events: 

EVENT_MENU_SELECTION 

EVENT_MENU_SELECTION_HELP_REQUEST 

EVENT_TIMER_EXPIRATION 

EVENT_EVENT_DOWNLOAD_MT_CALL 

EVENT_EVENT_DOWNLOAD_CALL_CONNECTED 

EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED 

EVENT_EVENT_DOWNLOAD_LOCATION_STATUS 

EVENT_EVENT_DOWNLOAD_USER_ ACTIVITY 

EVENT EVENT DOWNLOAD IDLE SCREEN AVAILABLE 
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EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS 

EVENT_EVENT_DOWNLOAD_LANGUAGE_SELECTION 

EVENT_EVENT_DOWNLOAD_BROWSER_TERMINATION 

EVENT_STATUS_COMMAND 

EVENT_PROFILE_DOWNLOAD 

EVENT_FIRST_COMMAND_AFTER_ATR 

EVENT_EVENT_DOWNLOAD_DATA_AVAILABLE 

EVENT_EVENT_DOWNLOAD_CHANNEL_STATUS 

EVENT_EVENT_DOWNLOAD_ACCESS_TECHNOLOGY_CHANGE 

EVENT_EVENT_DOWNLOAD_DISPLAY_PARAMETERS_CHANGED 

EVENT_EVENT_DOWNLOAD_LOCAL_CONNECTION 

EVENT_APPLICATION_DESELECT 

EVENT_PROACTIVE_HANDLER_AVAILABLE 

EVENT_EVENT_DOWNLOAD_NETWORK_SEARCH_MODE_CHANGE 

EVENT_EVENT_BROWSING_STATUS 

EVENT_EXTERNAL_FILE_UPDATE 

CRRC2: The EnvelopeResponseHandler shall not be available if the getTheHandler() method is not called, 
directly or indirectly, from the applet's /?race.sirooZA:/f() method. 



5.5.1.4.2 

Test Source: 
Test Applet: 



Cap File: 
5.5.1.4.3 



Test area files 

Test_Cre_Mha_Erhd.j ava. 
Cre_Mha_Erhd_ 1 .j a va . 
Cre_Mha_Erhd_2.j ava. 
Cre_Mha_Erhd_3 .j ava. 
Cre_Mha_Erhd.cap. 

Test coverage 



CRR Number 


Test Case Number 


CRRN1 


18, 19,20,21 


CRRN2 


18, 19 


CRRN3 


18, 19 


CRRN4 


1 to 29 


CRRC1 


1 to17and22to25, 26, 27, 28 


CRRC2 


29 
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5.5.1.4.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Tooll<it Appletl and Toolkit Applet2 

registration and Envelope Response Handler 

availability with 

EVENT_FIRST_COMMAND_AFTER_ATR 








1- Appletl is registered to all events 


1- No exception is thrown 






defined in ETSI TS 102 241 [13] except 








EVENT_PROACTIVE_HANDLER_AVAILABLE. 








Using the methods initMenuEntry () for 








EVENT_MENU_SELECTION, 








requestPollInterval for 








EVENT_STATUS_COMMAND, allocateTimer ( ) for 








EVENT_TIMER_EXPIRATION, 








allocateServiceldentif ier for 








EVENT_EVENT_DOWNLOAD_LOCAL_CONNECTION and 








setEventList for the rest of the events. 








Appletl is registered on 








EVENT_EXTERNAL_FILE_UPDATE on update of 








EFtaho of the UICC file system 








Applet2 is registered to 








EVENT_UNREC0GNIZED_ENVEL0PE . 








2- Select MF . 


2- Appletl is triggered by 

EVENT FIRST COMMAND AFTE 

R_ATR 






3- EnvelopeResponseHandler . getTheHandler ( ) 


3- A ToolkitException 






method is called by Appletl 


HANDLER_NOT_AVAILABLE is 
thrown 






Appletl is deregistered to 


Appletl finalizes 






EVENT_FIRST_COMMAND_AFTER_ATR. 




2 


Handler availability with 
EVENT_PROFILE_DOWNLOAD 








1- Terminal Profile command is sent to the 


1- Appletl Is Triggered By 






UICC without the facility of 


EVENT_PROFILE_DOWNLOAD 






SET_EVENT_LIST, SETUP_IDLE_MODE_TEXT, 








SETUP_MENU and POLL_INTERVAL . 








2- EnvelopeResponseHandler . getTheHandler ( ) 


2- A ToolkitException 






method is called by Appletl 


HANDLER_NOT_AVAILABLE is 






Appletl is deregistered to 


thrown 






EVENT_PROFILE_DOWNLOAD 


Appletl finalizes 




3 


Envelope Response Handler availability with 
EVENT_MENU_SELECTION_HELP_REQUEST 

Perform UICC initialization with all the 
facilities supported, except facility SET 
UP EVENT LIST 








1- Envelope menu selection with help 


1- Appletl is triggered 






request is sent to the UICC 








2- EnvelopeResponseHandler . getTheHandler ( ) 


2- A ToolkitException 






method is called by Appletl 


HANDLER_NOT_AVAILABLE is 

thrown 

Appletl finalizes 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


4 


Envelope Response Handler availability with 
EVENT_MENU_SELECTION 

1- A envelope menu selection is sent to 
the UICC 

2- EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 


1- Appletl is triggered 

2- A ToolkitException 

HANDLER_NOT_AVAILABLE is 

thrown 

Appletl finalizes 




5 


Envelope Response Handler availability with 
EVENT_TIMER_EXPIRATION 

1- Envelope Timer Expiration is sent to 
the UICC 

2- EnvelopeResponseHandler .getTheHandler () 
method is called by Appletl 


1- Appletl is triggered 

2- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 




6 


Envelope Response Handler availability with 
EVENT_EVENT_DOWNLOAD_MT_CALL 

1- Envelope event download mt call is sent 
to the UICC 

2- EnvelopeResponseHandler .getTheHandler () 
method is called by Appletl 


1- Appletl is triggered 

2- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 




7 


Envelope Response Handler availability with 

EVENT EVENT DOWNLOAD CALL CONNECT 

ED 

1- Envelope event download call connected 
is sent to the UICC 

2- EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 


1- Appletl is triggered 

2- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 




8 


Envelope Response Handler availability with 

EVENT EVENT DOWNLOAD CALL DISCONN 

ECTED 

1- Envelope event download call 
disconnected is sent to the UICC 

2- EnvelopeResponseHandler .getTheHandler () 
method is called by Appletl 


1- Appletl is triggered 

2- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 




9 


Envelope Response Handler availability with 

EVENT EVENT DOWNLOAD LOCATION STA 

TUS 

1- Envelope event download location status 
is sent to the UICC 

2- Appletl obtains the Envelope Response 
Handler 


1- Appletl is triggered 

2- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


10 


Envelope Response Handler availability with 
EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 

1- Envelope event download user activity 
is sent to the UICC 

2- EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 


1- Appletl is triggered 

2- A ToolkitException 

HANDLER_NOT_AVAILABLE is 

thrown 

Appletl finalizes 




11 


Envelope Response Handler availability with 

EVENT EVENT DOWNLOAD IDLE SCREEN 

AVAILABLE 

1- Envelope event download idle screen 
available is sent to the UICC 

2- EnvelopeResponseHandler .getTheHandler () 
method is called by Appletl 


1- Appletl is triggered 

2- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 




12 


Envelope Response Handler availability with 

EVENT EVENT DOWNLOAD CARD READER 

_STATUS 

1- Envelope event download card reader 
status is sent to the UICC 

2- EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 


1- Appletl is triggered 

2- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 




13 


Envelope Response Handler availability with 

EVENT EVENT DOWNLOAD LANGUAGE 

SELECTION 

1- Envelope event download language 
selection is sent to the UICC 

2- EnvelopeResponseHandler .getTheHandler () 
method is called by Appletl 


1- Appletl is triggered 

2- A ToolkitException 

HANDLER_NOT_AVAILABLE is 

thrown 

Appletl finalizes 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


14 


Envelope Response Handler availability with 

EVENT EVENT DOWNLOAD BROWSER 

TERMINATION 

1- Envelope event download browser 
termination is sent to the UICC 

2- EnvelopeResponseHandler . getTheHandler () 
method is called by Appletl 


1- Appletl is triggered 

2- A ToolkitException 

HANDLER_NOT_AVAILABLE is 

thrown 

Appletl finalizes 




15 


Envelope Response Handler availability with 
EVENT_STATUS_COMMAND 

1- status command is sent to the UICC 

2- EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 


1- Appletl is triggered 

2- A ToolkitException 

HANDLER_NOT_AVAILABLE is 

thrown 

Appletl finalizes 




16 


Envelope Response Handler availability with 

EVENT EVENT DOWNLOAD DATA AVAILAB 

LE 

1- Appletl Initializes a proactive command 
OPEN CHANNEL and calls the sendO method. 

2- Envelope event download data avalalble 
Is sent to the UICC with channelld=01 

3- EnvelopeResponseHandler . getTheHandler ( ) 

method Is called by Appletl 


2- Appletl is triggered 

3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 


1- The OPEN CHANNEL 
command is fetched 
TERMINAL RESPONSE IS 
SENT TO THE UICC with 
channel ld=01 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


17 


Envelope Response Handler availability with 

EVENT EVENT DOWNLOAD CHANNEL STAT 

US 

1- Envelope event download channel status 
is sent to the UICC with channelld=01 

2- EnvelopeResponseHandler . getTheHandler () 
method is called by Appletl 


1- Appletl is triggered 

2- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 
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Id 



Description 



API/CAT RE Expectation 



APDU Expectation 



18 



Envelope Response Handler availability with 
EVENT_CALL_CONTROL_BY_NAA 

1- Envelope call control by NAA is sent to 
the UICC 

2- EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 

3- Appletl builds the envelope response 
and it calls the postAsBERTLV ( ) method 

4- Appletl calls all methods of the 
Envelope Response Handler (including the 
inherited method) 



5- Envelope call control by NAA is sent to 
the UICC 

6- EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 

7- Appletl builds a proactive command and 
it calls the sendO method 



8- Appletl calls all methods of the 
Envelope Response Handler (including the 
inherited method) 



1- Appletl is triggered 



2- No exception is tlirown 



4- Tooll<itException 
HANDLER_NOT_AVAILABLE is 
thrown for eacli metliod 
Appletl finalizes 

5- Appletl is triggered 



6- No Exception is thrown 



8- A ToolkitException 
HANDLER_NOT_AVAILABLE Is 
thrown for each method 

Appletl finalizes 



3- The envelope response is 
sent 



7- The proactive command 
is fetched and the Terminal 
response is issued 
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Id 



Description 



API/CAT RE Expectation 



APDU Expectation 



19 



Envelope Response Handler availability with 
EVENT_UNRECOGNIZED_ENVELOPE 

1- An unrecognized Envelope is sent to the 
UICC 

2- EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 

3- Appletl builds the envelope response 
and it calls the postAsBERTLV ( ) or post 
method 

4-Appletl calls all methods of Envelope 
Response Handler (including the inherited 
method) 



5- EnvelopeResponseHandler . getTheHandler ( ) 
method is called 



6- An unrecognized Envelope is sent to the 

UICC 

7- EnvelopeResponseHandler . getTheHandler ( ) 

method is called 

8- Appletl builds a proactive command and 
it calls the send() method 

9- Appletl calls all methods of the 
Envelope Response Handler (including the 
inherited method) 



10- 

EnvelopeResponseHandler . getTheHandler ( ) 

method is called by Applet2 



1- Appletl is triggered 

2- No exception is tlirown 



3- The envelope response is 
sent 



4- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown for each method 

Appletl finalizes 
Applet2 is triggered 

5- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown. 

Applet2 finalizes 

6- Appletl is triggered 

7- No exception is thrown 



9- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown for each method 

Appletl finalizes 
Applet2 is triggered 

10- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown. 



9- The proactive command 
is fetched and the Terminal 
response is issued 



Applet2 finalizes 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


20 


The envelope response is sent when a 
proactive session is ongoing 

1- An unrecognized envelope is sent to the 
UICC. 

2- Proactive command DISPLAY TEXT is built 
and it calls the sendO method. 

3- A call control by NAA envelope is sent 
to the Dice. 

4- EnvelopeResponseHandler . getTheHandler () 
method is called by Appletl 

5- Appletl builds the envelope response 
and it calls the postAsBERTLV () 


1- Appletl is triggered. 

3- Appletl is triggered 

4- No exception is thrown 


2- 91 XX 

5- The envelope response is 

checked 

Expected SW = 91 XX 

Fetch DISPLAY TEXT 

Terminal Response 

DISPLAY TEXT 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


21 


Envelope Response Handler availability with 

EVENT_UNRECOGNIZED_ENVELOPE in case 

of multi-triggering 

1- An unrecognized Envelope is sent to the 

UICC 

2- EnvelopeResponseHandler . getTheHandler () 
method is called by Appletl 

3- EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Applet2 


1- Appletl is triggered 

2- No exception is tlirown 

Appletl finalizes 
Applet2 is triggered 

3- No Exception is thrown 
Applet2 finalizes 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


22 


Envelope Response Handler availability with 

EVENT EVENT DOWNLOAD ACCESS TECHN 

OLOGY_CHANGE 

1- Envelope event download access 
technology change is sent to the UICC 

2- EnvelopeResponseHandler . getTheHandler () 
method is called by Appletl 


1- Appletl is triggered 

2- A ToolkitException 

HANDLER_NOT_AVAILABLE is 

thrown 

Appletl finalizes 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


23 


Envelope Response Handler availability with 

EVENT EVENT DOWNLOAD DISPLAY PARA 

METERS_CHANGED 

1- Envelope event download display 
parameter changed is sent to the UICC 

2- EnvelopeResponseHandler . getTheHandler () 
method is called by Appletl 


1- Appletl is triggered and registers 
to 

EVENT PROACTIVE HANDLER 
AVAILABLE 

2- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


24 


Envelope Response Handler availability with 
EVENT_PROACTIVE_HANDLER_AVAILABLE 

2- EnvelopeResponseHandler . getTheHandler ( ) 


1- Appletl is triggered by 
EVENT PROACTIVE HANDLER 
AVAILABLE 






method is called by Appletl 


2- A ToolkitException 
HANDLER_NOT_AVAILABLE Is 
thrown 








3- Appletl sends a DECLARE 


3- DECLARE SERVICE 






SERVICE (add) proactive 
command with its service identifier 


(add) proactive command is 
fetched 

Successful TERMINAL 
RESPONSE is issued 






Appletl finalizes 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


25 


Envelope Response Handler availability with 

EVENT EVENT DOWNLOAD LOCAL CONNA 

CTION 








1- Envelope event download local 
connection is sent to the UICC with the 


1- Appletl is triggered 






allocated service Id of Appletl 








2- EnvelopeResponseHandler . getTheHandler () 
method is called by Appletl 


2- A ToolkitException 
HANDLER_NOT_AVAILABLE Is 
thrown 
Appletl finalizes 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


26 


Envelope Response Handler availability with 
EVENT_APPLICATION_DESELECT 

1- Select for activation ADFl 

2- Select for termination ADFl 

3- EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 

Appletl deregisters to 
EVENT_APPLICATION_DESELECT 


2- Appletl is triggered 

3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 




27 


Envelope Response Handler availability with 

EVENT EVENT DOWNLOAD NETWORK SEA 

RCH_MODE_CHANGE 

1- Envelope event download network search 
mode change is sent to the UICC 

2- EnvelopeResponseHandler .getTheHandler () 
method is called by Appletl 


1 - Appletl is triggered 

2- A ToolkitException 

HANDLER_NOT_AVAILABLE is 

thrown 

Appletl finalizes 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


28 


Envelope Response Handler availability with 
EVENT_EVENT_BROWSING_STATUS 

1- Envelope event download browsing status 
is sent to the UICC 

2- EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 


1- Appletl is triggered 

2- A ToolkitException 
HANDLER_NOT_AVAILABLE Is 
thrown 

Appletl finalizes 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


29 


The EnvelopeResponseHandler is not available 
outside the processToolkit() method 

1- Install Applets. In its install method, 
Applets gets the EnvelopeResponseHandler 
in a Try/Catch session 

2- Select Applets 

3- Applets gets the 
EnvelopeResponseHandler 


1- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

2- Applets is triggered by its 
processO method 

3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 





5.5.2 Handler Integrity 
5.5.2.1 ProactiveHandler 

Test Area Reference: Cre_Hin_Pahd 

5.5.2.1.1 Conformance requirement 

5.5.2.1 .1 .1 Normal execution 

• CRRNl: At the processToolkit invocation the TLV-List is cleared. 

• CRRN2: After a call to ProactiveHandler. send() method the content of the handler shall not be modified by 
the CAT Runtime Environment. 

• CRRN3: At the call of its init method the content is cleared and then initialized. 



5.5.2.1.1.2 

No requirements. 

5.5.2.1.1.3 

No requirements. 

5.5.2.1.2 

Test Source: 
Test Applet: 

Cap File: 
5.5.2.1.3 



Parameter errors 
Context errors 
Test area files 

Te s t_Cre_Hin_Pahd .Java. 
Cre_Hin_Pahd_ 1 .j ava. 
Cre_Hin_P ahd_2 .Java. 
Cre_Hin_Pahd.cap. 

Test coverage 



CRR Number 


Test Case Number 


CRRNl 


1,2,3,4 


CRRN2 


3 


CRRN3 


5 
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5.5.2.1.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


At the processToolkit invocation the TLV-List 
is cleared 

Appletl and Applet2 are registered to 
EVENT_EVENT_DOWNLOAD_USER_ACTIVITY. 

1-An envelope containing an event download 
user activity is sent to the UICC 

2-ProactiveHandler . getLength ( ) method is 
called by Appletl 


1- Appletl is triggered. 

2- The return value is 




2 


TLV-List change after the init method 
invocation 

ProactiveHandler . init method is called 
by Appletl 

1-ProactiveHandler .getLength {) method is 
called by Appletl 


1- The return value is 9 




3 


The TLV-List remains unchanged after the 
send() method invocation 

1- ProactiveHandler . send ( ) method is 
called by Appletl 

2- ProactiveHandler .getLength method is 
called by Appletl 

It is checked that the content is the same 
than before the calling to send method 
using ProactiveHandler . copy and 
Util . arrayCompare methods 


2- The return value is 9, and its 
contents is the same than before 
the calling to send method 

Appletl finalizes 


1 - The proactive command 
is fetched and the terminal 
response is issued. 



ETSI 



Release 6 



585 



ETSI TS 102 268 V6.0.0 (2007-03) 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


4 


At the processToolkit invocation the TLV-List 
is cleared 


Applet2 is triggered 






1- ProactiveHandler . getLength ( ) method is 


1- The return value is 






called by Applet2 








2- ProactiveHandler . getValueLength ( ) 
method is called by Applet2 


2- Tooll<itException 
UNAVAILABLE_ELEMENT is 
thrown 




5 


At the call of its init method the content is 
cleared and then initialized 








1- ProactiveHandler . init ( ) method is 
called by Applet2 


1 - Check that the content of the 
proactive handler corresponds to 
the command defined by the 
parameters of the init() method 






2- ProactiveHandler . initCloseChannel () 
method is called by Applet2 


2- Check that the content of the 
proactive handler corresponds to 
the close channel command 






3- ProactiveHandler . initDisplayText () 
method is called by Applet2 


3- Check that the content of the 
proactive handler corresponds to 
the display text command 






4- ProactiveHandler . InitGetlnkey method 


4- Check that the content of the 






is called by Applet2 


proactive handler corresponds to 
the get inkey command 






5- ProactiveHandler . InitGetlnput method 
is called by Applet2 


5- Check that the content of the 
proactive handler corresponds to 
the get input command 






6- ProactiveHandler . InitMoreTime ( ) method 
is called by Applet2 


6- Check that the content of the 
proactive handler corresponds to 
the IVIore Time command 






7- ProactiveHandler . init method is 
called by Applet2 


7- Check that the content of the 
proactive handler corresponds to 
the command defined by the 
parameters of the init() method 





5.5.2.2 



ProactiveResponseHandler 



Test Area Reference: Cre_Hin_Prhd. 



5.5.2.2.1 



5.5.2.2.1.1 



Conformance requirement 
Normal execution 



CRRNl: The ProactiveResponseHandler content shall be updated after each successful call to 
ProactiveHandler. send() method and shall remain unchanged until the next successful call to the 
Proactive Handle r.sendO method. 

CRRN2: The ProactiveResponseHandler TLV list is filled with the comprehension TLV data objects of the 
last TERMINAL RESPONSE APDU command. 

CRRN3: The comprehension TLV data objects shall be provided in the order given in the TERMINAL 
RESPONSE command data. 
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CRRN4: The ProactiveResponseHandler TLV list shall be empty before the first call to the 
ProactiveHandler.sendO method. 



5.5.2.2.1.2 

No requirements. 

5.5.2.2.1.3 

No requirements. 

5.5.2.2.2 

Test Source: 
Test Applet: 
Cap File: 

5.5.2.2.3 



Parameter errors 
Context errors 
Test area files 

Test_Cre_Hin_Prhd.j ava. 
Cre_Hin_Prhd_ 1 .j ava. 
Cre_Hin_Prhd. cap . 

Test coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


2 


CRRN3 


2 


CRRN4 


1 
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5.5.2.2.4 



Test procedure 



Id 



Description 



API/CAT RE Expectation 



APDU Expectation 



Applet registration and 
ProactiveResponseHandler obtaining 

1- Applet is registered to all events 
defined in ETSI TS 102 241 [13] except to 
EVENT_FIRST_COMMAND_AFTER_ATR, 
EVENT_PROACTIVE_HANDLER_AVAILABLE and 
EVENT_APPLICATION_DESELECT . 

Using the methods initMenuEntry for 
EVENT_MENU_SELECTION and 
EVENT_MENU_SELECTION_HELP_REQUEST 
requestPollInterval for 

EVENT_STATUS_COMMAND, allocateTlmer ( ) for 
EVENT_TIMER_EXPIRATION, 
allocateServiceldentif ier for 
EVENT_EVENT_DOWNLOAD_LOCAL_CONNECTION and 
setEventLlst ( ) for the rest of the events. 
Applet is registered on 

EVENT_EXTERNAL_FILE_UPDATE on update of 
EFiaHo of the UICC file system 

Terminal Profile command is sent to the 
UICC without the facilities of 
SETUP_EVENT_LIST, SETUP_IDLE_MODE_TEXT, 
SETUP_MENU and POLL_INTERVAL . 

2- For each event/triggering: 



3- 

ProactiveResponseHandler . getTheHandler ( ) 

is called 

4- ProactiveResponseHandler .getLength is 
called 



1 - No exception is thrown 



2- Applet is triggered. 

For the first triggering, the applet 
registers to 

EVENT_PROACTIVE_HANDLER 
AVAILABLE 

3- No exception is thrown 



4- The return value is 



The ProactiveResponseHandler remains 

unchanged after send() method invocation 

until next send() method invocation 

1- Applet builds a proactive command then 
the ProactiveHandler . send ( ) method is 
called 



ProactiveResponseHandler . getTheHandler ( ) 

method is called 



3-ProactiveResponseHandler . getLength ( ) 

method is called 

4-ProactiveHandler . init ( ) method is called 



5-ProactiveHandler . send ( ) method is called 



ProactiveResponseHandler . getTheHandler ( ) 
method is called 



2- The ProactiveResponseHandler 
contains the terminal response. 
Comprehension TLV are provided 
in the order of the Terminal 
Response APDU 

3- The return value is 12 



4- No exception is thrown and the 
Proactive Response Handler 
remains unchanged 



6- The ProactiveResponseHandler 
contains the terminal response of 
the second proactive command. 
Comprehension TLV are provided 
in the order of the Terminal 
Response APDU 



1- A proactive command is 

fetched 

The terminal response is sent 

with length 12 



5- A proactive command is 

fetched 

The terminal response is sent 

with length 15 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 




7-ProactiveResponseHandler .getLength () 

method is called 


7- The return value is 15 





5.5.2.3 EnvelopeHandler 

Test Area Reference: Cre_Hin_Enhd 



5.5.2.3.1 



5.5.2.3.1.1 



Conformance requirement 
Normal execution 



CRRNl: When available, the EnvelopeHandler shall remain available and its content shall remain unchanged 
from the invocation to the termination of the processToolkit() method. 

CRRN2: The EnvelopeHandler TLV list is filled with the Comprehension TLV data objects of the 
ENVELOPE APDU command. The Comprehension TLV data objects shall be provided in the order given in 
the ENVELOPE command data. 

CRRN3: When an applet is triggered by the EVENT _EXTERNAL_FILE_UPDATE event, the system Envelope 
Handler shall be available 

CRRN4: When an applet is triggered by the EVENT _EXTERNAL_FILE_UPDATE event, the Envelope 
Handler shall contains the following COMPREHENSION TLVs (the order of the TLVs given in the system 
EnvelopeHandler is not specified): 

Device Identity with source set to terminal and destination set to UICC, as defined in TS 102 223 [7]; 

File List, as defined in TS 102 223 [7]. The number of files shall be set to one. If a SFI referencing is 
used in the APDU Command, it shall be converted to its File Identifier; 

AID of the ADF, as defined in TS 102 223 [7], if the updated file belongs to an ADF. In this case, the 
path '3F007FFF' given in the File List indicates the ADF of the UICC application given through the AID. 
If the updated file belongs to the UICC shared file system, the AID TLV object is not present; 

File Update Information object. 



Byte(s) 


Description 


Length 


1 


File Update Information tag 


1 


2 


Length = 4 


1 


3 to 4 


Position 


2 


5 to 6 


Number of bytes updated 


2 



Position depends on the file type: 

In case of transparent file. Position = Offset 

In case of record file. Position = Absolute Record number 

For the INCREASE APDU, the number of bytes updated is the record length. 

CRRN5: The value returned upon a getTagO method invocation is equal to the BER-TLV tag for intra-UICC 
communication, as defined in ETSI TS 101 220 [5] 



5.5.2.3.1.2 

No requirements. 

5.5.2.3.1.3 

No requirements. 



Parameter errors 



Context errors 
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5.5.2.3.2 

Test Source: 
Test Applet: 
Cap File: 

5.5.2.3.3 



Test area files 

Test_Cre_Hin_Enhd.j ava. 
Cre_Hin_Enhd_ 1 .j a va . 
Cre_Hin_Enhd . cap . 

Test coverage 



CRR Number 


Test Case Number 


CRRN1 


1 to 21 


CRRN2 


1 to 21 


CRRN3 


22,23 


CRRN4 


22,23 


CRRN5 


1 
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5.5.2.3.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Applet initialization and Envelope Handler 

integrity checks with 

EVENT_MENU_SELECTION_HELP_REQUEST 








1- Applet is registered to all events 
defined in ETSI TS 102 241 [13] except 


1-No exception is thrown 






EVENT_PROFILE_DOWNLOAD, 








EVENT_PROACTIVE_HANDLER_AVAILABLE and 








EVENT_STATUS_COMMAND . 








Using the methods initMenuEntry () for 








EVENT_MENU_SELECTION and 








EVENT_MENU_SELECTION_HELP_REQUEST, 








allocateXimer for EVENT_TIMER_EXPIRATION, 








allocateServiceldentifier for 








EVENT_EVENT_DOWNLOAD_LOCAL_CONNECTION and 








setEventList ( ) for the rest of the events. 








Perform UICC initialization with all the 








facilities supported 








Applet is registered on 








EVENT_EXTERNAL_FILE_UPDATE on update of 








EFtaru of the UICC file system and on update 
of EFlaro of the ADF file system 


2- Applet is triggered 






2- Envelope menu selection with help 


3- No exception is thrown. 






request is sent to the UICC 








3- EnvelopeHandler .getTheHandler method 








is called 


4- No exception is thrown 






4- Copy the contents of the envelope 








handler in buffer 1 using 








EnvelopeHandler . copy ( ) 








The EnvelopeHandler . findTLVO method is 








called with TAG_HELP_REQUEST 








5- EnvelopeHandler . getTag ( ) method is 








called 




6- 91 XX. 




6- A proactive command DISPLAY TEXT is sent 


5- 0xD3 is returned 






7- Envelope call control by NAA is sent to 








UICC 


7- Applet is triggered 






EnvelopeHandler . getTheHandler ( ) method is 








called 








8- It is checked that the contents of the 


8- No exception is thrown and the 






envelope handler is the envelope call 


handler contains the envelope call 






control using EnvelopeHandler . copy ( ) and 


control by NAA 


A proactive command 




Util . arrayCompare {) methods 




Display Text is fetched 




The EnvelopeHandler . findTLV method is 
called with TAG_DEVICE_IDENTITIES 




The terminal Response of 
DISPLAY TEXT is sent to 




Call Control execution is finished. 




the UICC 




9- Check that the TAG_HELP_REQUEST is the 








TLV selected 








10- The contents of EnvelopeHandler are 


10- The contents of the envelope 






compared with bufferl using 


handler shall be the same as stored 






Util . arrayCompare () 


in bufferl 




2 


Envelope Handler integrity checks with 
EVENT_MENU_SELECTION 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 




1- An envelope menu selection is sent to 
UICC 


1- Applet is triggered 






2- EnvelopeHandler . getTheHandler ( ) method 


2- No exception is thrown. 






is called 








3- Copy the contents of the envelope 


3- No exception is thrown. 






handler in buffer 1 using 








EnvelopeHandler . copy ( ) 








The EnvelopeHandler . findTLV method is 








called with TAG_ITEM_IDENTIFIER 








4- A proactive command DISPLAY TEXT is sent 




4- 91 XX 




5- Envelope call control by NAA is sent to 


5- Applet is triggered 






UICC 








EnvelopeHandler .getTheHandler method is 








called 


6- No exception is thrown and the 






6- It is checked the contents of the 
envelope handler is the envelope call 


handler contains the envelope call 
control by NAA 






control using EnvelopeHandler . copy ( ) and 








Util . arrayCompare methods 








The EnvelopeHandler . findTLV method is 








called with TAG_DEVICE_IDENTITIES 








Call Control execution is finished 




Proactive command Display 
Text is fetched 
The terminal Response of 
DISPLAY TEXT is sent to 




7- It is checked that the 




the UICC 




TAG_ITEM_IDENTIFIER is the TLV selected 








8- The contents of EnvelopeHandler are 


8- The contents of the envelope 






compared with bufferl using 


handler shall be the same as stored 






Util . arrayCompare ( ) 


in bufferl 
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Id 



Description 



API/CAT RE Expectation 



APDU Expectation 



Envelope Handler Integrity checks with 
EVENT_TIMER_EXPIRATION 

1- A timer expiration envelope is sent to 
UICC 

2- EnvelopeHandler . getTheHandler ( ) method 
is called 

3- Copy the contents of the envelope 
handler in buffer 1 using 
EnvelopeHandler . copy ( ) 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_TIMER_ID 

4- A proactive command DISPLAY TEXT is sent 

5- Envelope call control by NAA is sent to 
Dice 

EnvelopeHandler . getTheHandler ( ) method is 
called 

6- It is checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy ( ) and 
Util . arrayCompare methods 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished 



1- Applet is triggered 

2- No exception is thrown. 

3- No exception is thrown. 



7- It is checked that the TAG_TIMER_ID is 
the TLV selected 

8- The contents of EnvelopeHandler are 
compared with bufferl using 

Util . arrayCompare ( ) 



5- Applet is triggered 



6- No exception is thrown and the 
handler contains the envelope call 
control by NAA 



4- 91 XX 



7- The contents of the envelope 
handler shall be the same as stored 
in bufferl 



Proactive command Display 
Text is fetched 

The terminal Response of 
DISPLAY TEXT is sent to 
the UICC 
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Id 



Description 



API/CAT RE Expectation 



APDU Expectation 



Envelope Handler Integrity checks with 
EVENT_CALL_CONTROL_BY_NAA 

1- A call control envelope is sent to UICC 

2- EnvelopeHandler . getTheHandler ( ) method 
is called 

3- Copy the contents of the envelope 
handler in buffer 1 using 
EnvelopeHandler . copy ( ) 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG„ADDRESS 

4- A proactive command DISPLAY TEXT is sent 

5- Envelope call control by NAA is sent to 
UICC 

EnvelopeHandler . getTheHandler ( ) method is 
called 

6- It is checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy ( ) and 
Util . arrayCompare methods 

The EnvelopeHandler . findTLV method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished 



1- Applet is triggered 

2- No exception is thrown. 

3- No exception is thrown. 



4- 91 XX 



5- Applet is triggered 



6- No exception is thrown and the 
handler contains the envelope call 
control by NAA 



7- It is checked that the TAG_ADDRESS is 
the TLV selected 

8- The contents of EnvelopeHandler are 
compared with bufferl using 

Util . arrayCompare ( ) 



Proactive command Display 
Text is fetched 

The terminal Response of 
DISPLAY TEXT is sent to 
the UICC 



8- The contents of the envelope 
handler shall be the same as stored 
in bufferl 



Envelope Handler Integrity checks with EVENT_ 
EVENT_DOWNLOAD_IVIT_CALL 

1- A event download mt call envelope is 
sent to UICC 

2- EnvelopeHandler . getTheHandler ( ) method 
is called 

3- Copy the contents of the envelope 
handler in buffer 1 using 
EnvelopeHandler . copy ( ) 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_EVENT_LIST 

4- A proactive command DISPLAY TEXT is sent 

5- Envelope call control by NAA is sent to 

UICC 

EnvelopeHandler . getTheHandler ( ) method is 
called 

6- It is checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy ( ) and 
Util . arrayCompare {) methods 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_DEVICE_IDENTITIES 



1- Applet is triggered 



2- No exception is thrown. 



3- No exception is thrown. 



4- 91 XX 



5- Applet is triggered 



6- No exception is thrown and the 
handler contains the envelope call 
control by NAA 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 




Call Control execution is finished 




Proactive command Display 
Text is fetched 




7- It is checked that the TAG_EVENT_LIST 




The terminal Response of 
DISPLAY TEXT is sent to 




is the TLV selected 




the UICC 




8- The contents of EnvelopeHandler are 
compared with bufferl using 


8- The contents of the envelope 
handler shall be the same as stored 






Util . arrayCompare ( ) 


in buffer 1 
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Id 



Description 



API/CAT RE Expectation 



APDU Expectation 



Envelope Handler integrity checks with EVENT_ 
EVENT_DOWNLOAD_CALL_CONNECTED 

1- A event download call connected envelope 
is sent to UICC 

2- EnvelopeHandler . getTheHandler ( ) method 
is called 

3- Copy the contents of the envelope 
handler in buffer 1 using 
EnvelopeHandler . copy ( ) 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_EVENT_LIST 

4- A proactive command DISPLAY TEXT is sent 

5- Envelope call control by NAA is sent to 
Dice 

EnvelopeHandler . getTheHandler ( ) method is 
called 

6- It is checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy and 
Util . arrayCompare methods 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished 



7- It is checked that the TAG_EVENT_LIST is 
the TLV selected 

8- The contents of EnvelopeHandler are 
compared with bufferl using 

Util . arrayCompare ( ) 



1- Applet is triggered 



2- No exception is thrown. 



3- No exception is thrown. 



5- Applet is triggered 



6- No exception is thrown and the 
handler contains the envelope call 
control by NAA 



4- 91 XX 



Proactive command Display 
Text is fetched 

The terminal Response of 
DISPLAY TEXT is sent to 
the UICC 



8- The contents of the envelope 
handler shall be the same as stored 
in bufferl 
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Id 



Description 



API/CAT RE Expectation 



APDU Expectation 



Envelope Handler integrity checks with EVENT_ 
EVENT_DOWNLOAD_CALL_DISCONNECTED 

1- A event download call disconnected 
envelope is sent to UICC 

2- EnvelopeHandler . getTheHandler ( ) method 
is called 

3- Copy the contents of the envelope 
handler in buffer 1 using 
EnvelopeHandler . copy ( ) 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_EVENT_LIST 

4- A proactive command DISPLAY TEXT is sent 

5- Envelope call control by NAA is sent to 
Dice 

EnvelopeHandler . getTheHandler ( ) method is 
called 

6- It is checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy and 
Util . arrayCompare methods 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished 



7- It is checked that the TAG_EVENT_LIST 
is the TLV selected 

8- The contents of EnvelopeHandler are 
compared with bufferl using 

Util . arrayCompare ( ) 



1- Applet is triggered 



2- No exception is thrown. 



3- No exception is thrown. 



4- 91 XX 



5- Applet is triggered 



6- No exception is thrown and the 
handler contains the envelope call 
control by NAA 



Proactive command Display 
Text is fetched 
The terminal Response of 
DISPLAY TEXT is sent to 
the UICC 



8- The contents of the envelope 
handler shall be the same as stored 
in bufferl 



Envelope Handler integrity checks with EVENT_ 
EVENT_DOWNLOAD_LOCATION_STATUS 

1- A event download location status 
envelope is sent to UICC 

2- EnvelopeHandler . getTheHandler ( ) method 
is called 

3- Copy the contents of the envelope 
handler in buffer 1 using 
EnvelopeHandler . copy ( ) 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_LOCATION_STATUS 

4- A proactive command DISPLAY TEXT is sent 

5- Envelope call control by NAA is sent to 

UICC 

EnvelopeHandler . getTheHandler ( ) method is 
called 

6- It is checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy ( ) and 
Util . arrayCompare {) methods 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_DEVICE_IDENTITIES 



1- Applet is triggered 



2- No exception is thrown. 



3- No exception is thrown. 



4-91 XX 



5- Applet is triggered 



6- No exception is thrown and the 
handler contains the envelope call 
control by NAA 
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Id 



Description 



API/CAT RE Expectation 



APDU Expectation 



Call Control execution is finished 



7- It is checked that the 
TAG_LOCATION_STATUS is the TLV selected 

8- The contents of EnvelopeHandler are 
compared with bufferl using 

Util . arrayCompare ( ) 



Proactive command Display 
Text is fetched 

The terminal Response of 
DISPLAY TEXT is sent to 
the UICC 



8- The contents of the envelope 
handler shall be the same as stored 
in bufferl 



Envelope Handler integrity checks with EVENT_ 
EVENT_DOWNLOAD_USER_ACTIVITY 

1- A event download user activity envelope 
is sent to UICC 

2- EnvelopeHandler . getTheHandler ( ) method 
is called 

3- Copy the contents of the envelope 
handler in buffer 1 using 
EnvelopeHandler . copy ( ) 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_DEVICE_IDENTITIES 

4- A proactive command DISPLAY TEXT is sent 

5- Envelope call control by NAA is sent to 
UICC 

EnvelopeHandler . getTheHandler ( ) method is 
called 

6- It is checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy ( ) and 
Util . arrayCompare {) methods 

The EnvelopeHandler . findTLV method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished 



1- Applet is triggered 



2- No exception is thrown. 



3- No exception is thrown. 



7-It is checked that the 
TAG_DEVICE_IDENTITIES is the TLV selected 

8- The contents of EnvelopeHandler are 
compared with bufferl using 
Util . arrayCompare ( ) 



4- 91 XX 



5- Applet is triggered 



6- No exception is thrown and the 
handler contains the envelope call 
control by NAA 



Proactive command Display 
Text is fetched 



The terminal Response of 
DISPLAY TEXT is sent to 
the UICC 



8- The contents of the envelope 
handler shall be the same as stored 
in bufferl 
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Id 



Description 



API/CAT RE Expectation 



APDU Expectation 



10 



Envelope Handler integrity checks with EVENT_ 

EVENT_DOWNLOADJDLE_SCREEN_AVAILAB 

LE 

1- A event download idle screen available 
envelope is sent to UICC 

2- EnvelopeHandler . getTheHandler ( ) method 
is called 

3- Copy the contents of the envelope 
handler in buffer 1 using 
EnvelopeHandler . copy ( ) 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_DEVICE_IDENTITIES 

4- A proactive command DISPLAY TEXT is sent 

5- Envelope call control by NAA is sent to 

UICC 

EnvelopeHandler . getTheHandler ( ) method is 
called 

6- It is checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy ( ) and 
Util . arrayCompare methods 

The EnvelopeHandler . findTLV method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished 



1- Applet is triggered 



2- No exception is thrown. 



3- No exception is thrown. 



7- It is checked that the 
TAG_DEVICE_IDENTITIES is the TLV selected 

8- The contents of EnvelopeHandler are 
compared with bufferl using 

Util . arrayCompare ( ) 



5- Applet is triggered 



6- No exception is thrown and the 
handler contains the envelope call 
control by NAA 



4- 91 XX 



Proactive command Display 
Text is fetched 

The terminal Response of 
DISPLAY TEXT is sent to 
the UICC 



8- The contents of the envelope 
handler shall be the same as stored 
in bufferl 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


11 


Envelope Handler integrity checks with EVENT 
EVENT_DOWNLOAD_CARD_READER_STATUS 








1- A event download card reader status 
envelope is sent to UICC 


1- Applet is triggered 






2- EnvelopeHandler . getTheHandler ( ) method 
is called 


2- No exception is thrown. 






3- Copy the contents of the envelope 
handler in buffer 1 using 
EnvelopeHandler . copy ( ) 


3- No exception is thrown. 






The EnvelopeHandler . findTLV method is 
called with TAG_CARD_READER_STATUS 








4- A proactive command DISPLAY TEXT is sent 

5- Envelope call control by NAA is sent to 
Dice 


5- Applet is triggered 


4- 91 XX 




EnvelopeHandler .getTheHandler {) method is 
called 








6- It is checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy and 
Util . arrayCompare methods 


6- No exception is thrown and the 
handler contains the envelope call 
control by NAA 






The EnvelopeHandler . findTLV method is 
called with TAG_DEVICE_IDENTITIES 




Proactive command Display 
Text is fetched 




7- It is checked that the 
TAG_CARD_READER_STATUS is the TLV selected 




The terminal Response of 
DISPLAY TEXT is sent to 
the UICC 




8- The contents of EnvelopeHandler are 
compared with bufferl using 
Util . arrayCompare () 


8- The contents of the envelope 
handler shall be the same as stored 
in bufferl 
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Id 



Description 



API/CAT RE Expectation 



APDU Expectation 



12 



Envelope Handler Integrity checks with 
UNRECOGNIZED_ENVELOPE 

1- A unrecognized envelope is sent to UICC 

2- EnvelopeHandler . getTheHandler ( ) method 
is called 

3- Copy the contents of the envelope 
handler in buffer 1 using 
EnvelopeHandler . copy ( ) 

4- A proactive command DISPLAY TEXT is sent 

5- Envelope call control by NAA is sent to 
UICC 

EnvelopeHandler . getTheHandler ( ) method is 

called 

The EnvelopeHandler . getValueLength ( ) is 

called 

6- It is checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy ( ) and 
Util . arrayCompare methods 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished 



7- The contents of EnvelopeHandler are 
compared with bufferl using 
Util . arrayCompare ( ) 



1- Applet is triggered 

2- No exception is thrown. 

3- No exception is thrown. 
5- Applet is triggered 



6- No exception is thrown and the 
handler contains the envelope call 
control by NAA 



4- 91 XX 



7- The contents of the envelope 
handler shall be the same as stored 
in bufferl 



Proactive command Display 
Text is fetched 

The terminal Response of 
DISPLAY TEXT is sent to 
the UICC 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


13 


Envelope Handler integrity checks with 

EVENT EVENT DOWNLOAD LANGUAGE SEL 

ECTION 








1- A event download language selection 
envelope is sent to UICC 


1- Applet is triggered 






2- EnvelopeHandler .getTheHandler {) method 
is called 


2-No exception is tlirown. 






3- Copy the contents of the envelope 
handler in buffer 1 using 
EnvelopeHandler . copy ( ) 


3-No exception is thrown. 






The EnvelopeHandler . findTLV method is 
called with TAG_EVENT_LIST 








4- A proactive command DISPLAY TEXT is sent 

5- Envelope call control by NAA is sent to 




4-91 XX 




UICC 


5- Applet is triggered 






EnvelopeHandler . getTheHandler ( ) method is 
called 








6- It is checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy ( ) and 
Util . arrayCompare ( ) methods 


6- No exception is thrown and the 
handler contains the envelope call 
control by NAA 






The EnvelopeHandler . findTLV method is 
called with TAG_DEVICE_IDENTITIES 








Call Control execution is finished 




Proactive command Display 
Text is fetched 




7- It is checked that the TAG_EVENT_LIST is 
the TLV selected 

8- The contents of EnvelopeHandler are 
compared with bufferl using 

Util . arrayCompare ( ) 


8- The contents of the envelope 
handler shall be the same as stored 
in bufferl 


The terminal Response of 
DISPLAY TEXT is sent to 
the UICC 
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Id 



Description 



API/CAT RE Expectation 



APDU Expectation 



14 



Envelope Handler integrity checks with 

EVENT_EVENT_DOWNLOAD_BROWSER_TERM 

■NATION 

1- A event download browser termination 
envelope is sent to UICC 

2- EnvelopeHandler . getTheHandler ( ) method 
is called 

3- Copy the contents of the envelope 
handler in buffer 1 using 
EnvelopeHandler . copy ( ) 

The EnvelopeHandler . findTLV method is 
called with TAG_EVENT_LIST 

4- A proactive command DISPLAY TEXT is sent 

5- Envelope call control by NAA is sent to 

UICC 

EnvelopeHandler . getTheHandler ( ) method is 
called 

6- It is checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy ( ) and 
Util . arrayCompare methods 

The EnvelopeHandler . findTLV method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished 



1- Applet is triggered 



2-No exception is tlirown. 



3-No exception is thrown. 



5- Applet is triggered 



6- No exception is thrown and the 
handler contains the envelope call 
control by NAA 



7- It is checked that the TAG_EVENT_LIST is 
the TLV selected 

8- The contents of EnvelopeHandler are 
compared with bufferl using 

Util . arrayCompare ( ) 



4-91 XX 



Proactive command Display 
Text is fetched 

The terminal Response of 
DISPLAY TEXT is sent to 
the UICC 



8- The contents of the envelope 
handler shall be the same as stored 
in bufferl 
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API/CAT RE Expectation 


APDU Expectation 


15 


Envelope Handler integrity checks with 
EVENT EVENT DOWNLOAD DATA AVAILABL 

E 








1- The applet builds a proactive command 


1- The applet is registered to 


1- OPEN CHANNEL 




OPEN CHANNEL. 

proactiveHandler . send ( ) method is called 


EVENT EVENT DOWNLOAD DA 

TA AVAILABLE and 

EVENT EVENT DOWNLOAD CH 


proactive connmand is 
fetched 






ANNEL_STATUS 


TERMINAL RESPONSE is 
issued with Channel Id = 01 




2- A event download data available envelope 








is sent to UICC 


2- Applet is triggered 






3- EnvelopeHandler . getTheHandler ( ) method 








is called 


3-No exception is thrown. 






4- Copy the contents of the envelope 








handler in buffer 1 using 








EnvelopeHandler . copy ( ) 


4-No exception is thrown. 






The EnvelopeHandler . findTLV method is 








called with TAG_CHANNEL_STATUS 








5- A proactive command DISPLAY TEXT is sent 








6- Envelope call control by NAA is sent to 




5-91 XX 




UICC 








EnvelopeHandler . getTheHandler ( ) method is 


6- Applet is triggered 






called 








7- It is checked that the contents of the 
envelope handler is the envelope call 


7- No exception is thrown and the 






control using EnvelopeHandler . copy () and 


handler contains the envelope call 






Util . arrayCompare methods 


control by NAA 






The EnvelopeHandler . findTLV method is 








called with TAG_DEVICE_IDENTITIES 








Call Control execution is finished 




Proactive command Display 
Text is fetched 




8- It is checked that the 
TAG_CHANNEL_STATUS is the TLV selected 




The terminal Response of 
DISPLAY TEXT is sent to 
the UICC 




9- The contents of EnvelopeHandler are 


9- The contents of the envelope 






compared with bufferl using 


handler shall be the same as stored 






Util . arrayCompare ( ) 


in bufferl 
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Envelope Handler Integrity checks with 

EVENT_EVENT_DOWNLOAD_CHANNEL_STAT 

US 

1- A event download channel status envelope 
is sent to UICC 

2- EnvelopeHandler . getTheHandler ( ) method 
is called 

3- Copy the contents of the envelope 
handler in buffer 1 using 
EnvelopeHandler . copy ( ) 

The EnvelopeHandler . findTLV method is 
called with TAG_CHANNEL_STATUS 

4- A proactive command DISPLAY TEXT is sent 

5- Envelope call control by NAA is sent to 

UICC 

EnvelopeHandler . getTheHandler ( ) method is 
called 

6- It is checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy ( ) and 
Util . arrayCompare methods 

The EnvelopeHandler . findTLV method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished 



1- Applet is triggered 



2-No exception is tlirown. 



3-No exception is thrown. 



7- It is checked that the 
TAG_CHANNEL_STATUS is the TLV selected 

8- The contents of EnvelopeHandler are 
compared with bufferl using 

Util . arrayCompare ( ) 



5- Applet is triggered 



6- No exception is thrown and the 
handler contains the envelope call 
control by NAA 



4-91 XX 



Proactive command Display 
Text is fetched 

The terminal Response of 
DISPLAY TEXT is sent to 
the UICC 



8- The contents of the envelope 
handler shall be the same as stored 
in bufferl 
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API/CAT RE Expectation 



APDU Expectation 



17 



Envelope Handler integrity checks with EVENT_ 

EVENT_DOWNLOAD_ACCESS_TECHNOLOGY_ 

CHANGE 

1- A event download access technology 
change envelope is sent to UICC 

2- EnvelopeHandler . getTheHandler ( ) method 
is called 

3- Copy the contents of the envelope 
handler in buffer 1 using 
EnvelopeHandler . copy ( ) 

The EnvelopeHandler . findTLV method is 
called with TAG_ACCESS_TECHNOLOGY 

4- A proactive command DISPLAY TEXT is sent 

5- Envelope call control by NAA is sent to 

UICC 

EnvelopeHandler . getTheHandler ( ) method is 
called 

6- It is checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy ( ) and 
Util . arrayCompare methods 

The EnvelopeHandler . findTLV method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished 



1- Applet is triggered 



2- No exception is thrown. 



3- No exception is thrown. 



7- It is checked that the 
TAG_ACCESS_TECHNOLOGY is the TLV selected 

8- The contents of EnvelopeHandler are 
compared with bufferl using 

Util . arrayCompare ( ) 



5- Applet is triggered 



6- No exception is thrown and the 
handler contains the envelope call 
control by NAA 



4- 91 XX 



Proactive command Display 
Text is fetched 

The terminal Response of 
DISPLAY TEXT is sent to 
the UICC 



8- The contents of the envelope 
handler shall be the same as stored 
in bufferl 
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API/CAT RE Expectation 



APDU Expectation 



Envelope Handler integrity checks with EVENT_ 

EVENT_DOWNLOAD_DISPLAY_PARAMETER_C 

HANGED 

1- A event download display parameter 
changed envelope is sent to UICC 

2- EnvelopeHandler . getTheHandler ( ) method 
is called 

3- Copy the contents of the envelope 
handler in buffer 1 using 
EnvelopeHandler . copy ( ) 

The EnvelopeHandler . findTLV method is 
called with TAG_DISPLAY_PARAMETER 

4- A proactive command DISPLAY TEXT is sent 

5- Envelope call control by NAA is sent to 

UICC 

EnvelopeHandler . getTheHandler ( ) method is 
called 

6- It is checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy ( ) and 
Util . arrayCompare methods 

The EnvelopeHandler . findTLV method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished 



1- Applet is triggered 



2- No exception is thrown. 



3- No exception is thrown. 



7- It is checked that the 
TAG_DISPLAY_PARAMETER is the TLV selected 

8- The contents of EnvelopeHandler are 
compared with bufferl using 

Util . arrayCompare ( ) 



5- Applet is triggered 



6- No exception is thrown and the 
handler contains the envelope call 
control by NAA 



4- 91 XX 



Proactive command Display 
Text is fetched 

The terminal Response of 
DISPLAY TEXT is sent to 
the UICC 



8- The contents of the envelope 
handler shall be the same as stored 
in bufferl 

9- Applet sends a DECLARE 
SERVICE (add) proactive 
command with its service identifier 



9- DECLARE SERVICE 
(add) proactive command is 
fetched 

Successful TERMINAL 
RESPONSE is issued 
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Envelope Handler Integrity checks with EVENT_ 
EVENT_DOWNLOAD_LOCAL_CONNECTION 

1- A event download local connection 
envelope is sent to UICC with the allocated 
service Id of Applet 

2- EnvelopeHandler . getTheHandler ( ) method 
is called 

3- Copy the contents of the envelope 
handler in buffer 1 using 
EnvelopeHandler . copy ( ) 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_SERVICE_RECORD 

4- A proactive command DISPLAY TEXT is sent 

5- Envelope call control by NAA is sent to 
UICC 

EnvelopeHandler . getTheHandler ( ) method is 
called 

6- It is checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy ( ) and 
Util . arrayCompare methods 

The EnvelopeHandler . findTLV method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished 



1- Applet is triggered 



2- No exception is thrown. 



3- No exception is thrown. 



4- 91 XX 



5- Applet is triggered 



6- No exception is thrown and the 
handler contains the envelope call 
control by NAA 



7- It is checked that the 
TAG_SERVICE_RECORD is the TLV selected 

8- The contents of EnvelopeHandler are 
compared with bufferl using 

Util . arrayCompare ( ) 



Proactive command Display 
Text is fetched 

The terminal Response of 
DISPLAY TEXT is sent to 
the UICC 



8- The contents of the envelope 
handler shall be the same as stored 
in bufferl 



20 



Envelope Handler Integrity checks with EVENT_ 

EVENT_DOWNLOAD_NETWORK_SEARCH_MO 

DE_CHANGE 

1- A event download network search mode 
change envelope is sent to UICC 

2- EnvelopeHandler . getTheHandler ( ) method 
is called 

3- Copy the contents of the envelope 
handler in buffer 1 using 
EnvelopeHandler . copy ( ) 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_NETWORK_SEARCH_MODE 

4- A proactive command DISPLAY TEXT is sent 

5- Envelope call control by NAA is sent to 
UICC 

EnvelopeHandler .getTheHandler {) method is 
called 

6- It is checked that the contents of the 
envelope handler is the envelope call 



1- Applet is triggered 



2- No exception is thrown. 



3- No exception is thrown. 



4- 91 XX 



5- Applet is triggered 



6- No exception is thrown and the 
handler contains the envelope call 



ETSI 



Release 6 



608 



ETSI TS 102 268 V6.0.0 (2007-03) 



Id 
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API/CAT RE Expectation 


APDU Expectation 




control using EnvelopeHandler . copy { ) and 
Util . arrayCompare methods 


control by NAA 






The EnvelopeHandler . findTLV method is 








called with TAG_DEVICE_IDENTITIES 








Call Control execution is finished 




Proactive command Display 
Text is fetched 




7-It is checked that the 




The terminal Response of 
DISPLAY TEXT is sent to 




TAG_NETWORK_SEARCH_MODE is the TLV selected 




the UICC 




8- The contents of EnvelopeHandler are 


8- The contents of the envelope 






compared with bufferl using 
Util . arrayCompare () 


handler shall be the same as stored 
in bufferl 
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Envelope Handler integrity checks with EVENT 
EVENT_DOWNLOAD_BROWSING STATUS 

1- A event download browsing status 








envelope is sent to UICC 


1- Applet is triggered 






2- EnvelopeHandler . getTheHandler ( ) method 








is called 


2- No exception is thrown. 






3- Copy the contents of the envelope 








handler in buffer 1 using 








EnvelopeHandler . copy ( ) 


3- No exception is thrown. 






The EnvelopeHandler . findTLV method is 








called with TAG_BROWSING_STATUS 








4- A proactive command DISPLAY TEXT is sent 








5- Envelope call control by NAA is sent to 




4- 91 XX 




Dice 








EnvelopeHandler .getTheHandler {) method is 


5- Applet is triggered 






called 








6- It is checked that the contents of the 
envelope handler is the envelope call 


6- No exception is thrown and the 






control using EnvelopeHandler . copy ( ) and 
Util . arrayCompare methods 


handler contains the envelope call 
control by NAA 






The EnvelopeHandler . findTLV method is 








called with TAG_DEVICE_IDENTITIES 








Call Control execution is finished 




Proactive command Display 
Text is fetched 




7- It is checked that the 
TAG_BROWSING_STATUS is the TLV selected 




The terminal Response of 
DISPLAY TEXT is sent to 
the UICC 




8- The contents of EnvelopeHandler are 
compared with bufferl using 
Util . arrayCompare {) 


8- The contents of the envelope 
handler shall be the same as stored 
in bufferl 
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22 



Envelope Handler integrity checks with EVENT_ 
EXTERNAL_FILE_UPDATE under MF 

1- EFtaru of the UICC file system is updated 

2- EnvelopeHandler . getTheHandler ( ) method 
is called 

3- Copy the contents of the envelope 
handler in buffer 1 using 
EnvelopeHandler . copy ( ) 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_FILE_LIST 

4- A proactive command DISPLAY TEXT is sent 

5- Envelope call control by NAA is sent to 
UICC 

EnvelopeHandler . getTheHandler ( ) method is 
called 

6- It is checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy ( ) and 
Util . arrayCompare methods 

The EnvelopeHandler . findTLV method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished 



1- Applet is triggered 



2- No exception is thrown. 



3- No exception is thrown. 



7- It is checked that the TAG_FILE_LIST is 
the TLV selected 

8- The contents of EnvelopeHandler are 
compared with bufferl using 

Util . arrayCompare ( ) 



9- It is checked that the EnvelopeHandler 
contains the comprehension TLVs : Device 
Identity, File List and File Update 
Information with the correct value. 
The EnvelopeHandler does not contain the 
comprehension TLV AID 



5- Applet is triggered 



6- No exception is thrown and the 
handler contains the envelope call 
control by NAA 



4- 91 XX 



8- The contents of the envelope 
handler shall be the same as stored 
in bufferl 



Proactive command Display 
Text is fetched 

The terminal Response of 
DISPLAY TEXT is sent to 
the UICC 
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Envelope Handler integrity checks with EVENT_ 
EXTERNAL_FILE_UPDATE under ADF 

1- EFlaho of the ADF file system is updated 

2- EnvelopeHandler . getTheHandler ( ) method 
is called 

3- Copy the contents of the envelope 
handler in buffer 1 using 
EnvelopeHandler . copy ( ) 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_FILE_LIST 

4- A proactive command DISPLAY TEXT is sent 

5- Envelope call control by NAA is sent to 
UICC 

EnvelopeHandler . getTheHandler ( ) method is 
called 

6- It is checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy ( ) and 
Util . arrayCompare methods 

The EnvelopeHandler . findTLV method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished 



1- Applet is triggered 



2- No exception is thrown. 



3- No exception is thrown. 



7- It is checked that the TAG_FILE_LIST is 
the TLV selected 

8- The contents of EnvelopeHandler are 
compared with bufferl using 

Util . arrayCompare ( ) 



9- It is checked that the EnvelopeHandler 
contains the comprehension TLVs : Device 
Identity, File List, AID and File Update 
Information with the correct value. 



5- Applet is triggered 



6- No exception is thrown and the 
handler contains the envelope call 
control by NAA 



4- 91 XX 



8- The contents of the envelope 
handler shall be the same as stored 
in bufferl 



Proactive command Display 
Text is fetched 

The terminal Response of 
DISPLAY TEXT is sent to 
the UICC 



5.5.2.4 EnvelopeResponseHandler 

Test Area Reference: Cre_Hin_Erhd. 

5.5.2.4.1 Conformance requirement 

5.5.2.4.1.1 Normal execution 

• CRRNl: At the processToolkit invocation the TLV-List is cleared. 

5.5.2.4.1 .2 Parameter errors 
No requirements. 
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5.5.2.4.1.3 

No requirements. 

5.5.2.4.2 

Test Source: 
Test Applet: 
Cap_File: 

5.5.2.4.3 



5.5.2.4.4 



Context errors 
Test area files 

Test_Cre_Hin_Erhd.j ava. 
Cre_Hin_Erhd_ 1 .j ava. 
Cre_Hin_Erhd.cap. 

Test coverage 



CRR Number 


Test Case Number 


CRRN1 


1 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


At the processToolkit invocation the TLV-Llst is 
cleared 

Appletl is registered to 
EVENT_UNRECOGNIZED_ENVELOPE . 








1-An unrecognized envelope is sent to the 


1- Appletl is triggered 






UICC 








2- EnvelopeResponseHandler . getTheHandler ( ) is 








called by the Appletl. 








3- EnvelopeResponseHandler. get Length ( ) 
method is called by Appletl 


3- The return value shall be 





5.5.3 Applet Triggering 
5.5.3.1 General behaviour 

Test Area Reference: Cre_Apt_Genb. 

5.5.3.1.1 Conformance requirement 

5.5.3.1 .1 .1 Normal execution 

• CRRNl: When a first level application is the selected application and when a Toolkit Applet is triggered the 
selectQ method of the Toolkit Applet shall not be launched since the Toolkit Applet itself is not selected. 

• CRRN2: The CAT Runtime Environment shall only trigger a Toolkit Applet if it is in the selectable state as 
defined in TS 102 226 [10]. 

• CRRN3: When the CAT Runtime Environment has to trigger several applets on the same event, the next 
applet is triggered on the return of the processToolkit() method of the previous Toolkit Applet. 



5.5.3.1.1.2 

No requirements. 

5.5.3.1.1.3 

No requirements. 



Parameter errors 



Context errors 
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5.5.3.1.2 

Test Source: 
Test Applet: 
Cap File: 

5.5.3.1.3 



Test area files 

Test_Cre_Apt_Genb.java. 
Cre_Apt_Genb_l .Java. 
cre_apt_genb . c ap . 

Test coverage 



CR Number 


Test Case Number 


CRRN1 


Covered by all other tests of this clause (5.5.3) 


CRRN2 


1,2,3,4 


CRRN3 


Covered by all other tests of this clause (5.5.3) 



5.5.3.1.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Triggering an applet in the installed state 

When installed, the applet is registered 
to EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 

1- Install the applet without making it 
selectable 

2- Select the Applet by AID 

3- An envelope event download user 
activity is sent to the UICC 


2- Applet is not triggered 


1 - SW = 90 00 
2- SW si 90 00 


2 


Triggering an applet in the make selectable 
state 

1- Install the applet to make it 
selectable 

2- Select the Applet by AIDS- An envelope 
event download user activity is sent to 
the UICC 


2- Applet is triggered 


1 - SW = 90 00 
2- SW = 90 00 


3 


Triggering an applet in the lock state 

1- Set the applet in the lock state 

2- Select the Applet by AID 3- An envelope 
event download user activity is sent to 
the UICC 


2- Applet is not triggered 


1 - SW = 90 00 
2- SW + 90 00 


4 


Triggering an applet in the make selectable 
state 

1- Set the applet in the make selectable 
state 

2- Select the Applet by AID 3- An envelope 
event download user activity is sent to 
the UICC 


2- Applet Is triggered 


1 - SW = 90 00 
2- SW = 90 00 



5.5.3.2 EVENT_PROFILE_DOWNLOAD 

Test Area Reference: Cre_Apt_Epdw. 

5.5.3.2.1 Conformance requirement 

5.5.3.2.1.1 Normal execution 

• CRRN 1 : Upon reception of a TERMINAL PROFILE APDU command the CAT Runtime Environment shall 
store the terminal profile and trigger all the Toolkit Applet(s) registered to this event. 
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• CRRN2: The applet is not triggered by the EVENT_PROFILE_DOWNLOAD once it has deregistered from 
this event. 

• CRRN3: The CAT Runtime Environment shall not reply busy to a Terminal Profile command. 

5.5.3.2.1 .2 Parameter errors 
No requirements. 

5.5.3.2.1.3 Context errors 
No requirements. 

5.5.3.2.2 Test area files 

Test Source: Test_Cre_Apt_Epdw.java. 
Test Applet: Cre_Apt_Epdw_l.java. 

Cre_Apt_Epdw_2.j ava. 

Cre_Apt_Epdw_3 .j ava. 

cre_apt_epd w. c ap . 



Cap_File: 
5.5.3.2.3 



Test coverage 



CRR Number 


Test Case Number 


CRRN1 


1 


CRRN2 


3 


CRRN3 


2 



5.5.3.2.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Applets registration to 
EVENT_PROFILE_DOWNLOAD and triggering 

Appletl is registered to the 
EVENT„PROFILE_DOWNLOAD 

Applet2 is registered to the 
EVENT_PROF I LE_DOWNLOAD 

Applets is not registered to the 
EVENT_PROFILE_DOWNLOAD and is registered 
to EVENT_MENU_SELECTION. 








1-Terminal Profile command is sent to UICC 


1- Appletl is triggered 

Appletl finalizes 

2- Applet2 is triggered 

Applet2 finalizes 

3- Applet3 is not triggered 
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Id 
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API/CAT RE Expectation 



APDU Expectation 



The CAT Runtime Environment shall not reply 
busy to a Terminal Profile command 

l-Envelope menu selection is sent to the 
UICC 

Applets builds a REFRESH proactive command 
in UICC initialization mode 

2-ProactiveHandler . send ( ) method is called 
by applets 



3-Terminal Profile command is sent to the 
UICC 

Appletl calls ToolkitRegistry . clearEvent ( 
EVENT_PROF I LE_DOWNLOAD ) 



4-Applet2 calls 
ToolkitRegistry . clearEvent ( 
EVENT_PROFILE_DOWNLOAD) 



6-Applet3 calls 

ToolkitRegistry. setEvent (EVENT_PROFILE_DOW 

NLOAD) 



1- Applets is triggered by the 
EVENT IVIENU SELECTION 



Applets is suspended until the 
terminal response 



3- Appletl is triggered by 
EVENT PROFILE DOWNLOAD 



Appletl finalizes 

Applet2 is triggered by 

EVENT PROFILE DOWNLOAD 



Applet2 finalizes 



Applets finalizes 



2- A proactive command is 
sent 



5- The terminal response of 
the proactive command is 
sent 



Deregistered applets are not triggered 

Terminal Profile command is sent to the 
UICC 



Applets is triggered 
(Appletl and Applet2 are not 
triggered) 



5.5.3.3 EVENT_MENU_SELECTION 

Test Area Reference: Cre_Apt_Emse. 

5.5.3.3.1 Conformance requirement 

5.5.3.3.1.1 Normal execution 

• CRRN 1 : Upon reception of an ENVELOPE (MENU SELECTION) APDU command, the CAT Runtime 
Environment shall only trigger the Toolkit Applet registered to the corresponding event with the associated 
menu identifier. 



5.5.3.3.1.2 

No requirements. 

5.5.3.3.1.3 

No requirements. 



Parameter errors 



Context errors 
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5.5.3.3.2 

Test Source: 
Test Applet: 

Cap File: 
5.5.3.3.3 



Test area files 

Test_Cre_Apt_Emse.java. 
Cre_Apt_Emse_ 1 .j ava. 
Cre_Apt_Emse_2.j ava. 
cre_apt_emse.cap. 

Test coverage 



CRR Number 


Test Case Number 


CRRN1 


1 



5.5.3.3.4 



Test procedure 



Id 



Description 



API/CAT RE Expectation 



APDU Expectation 



Applet registration to 
EVENT_MENU_SELECTION and triggering 

ToolkitRegistry . initMenuEntry ( ) method is 
called at the installation of Appletl and 
Applet2 

For Appletl : 
MenuEntry="Appletl " 
Offset=0 

Length=menuEntry . length 
HelpSupported= false 
IconQualif ier=0 
Iconldentif ier=0 

For Applet2 : 
MenuEntry="Applet2" 
Offset=0 

Length=menuEntry . length 
HelpSupported=true 
IconQualif ier=0 
Iconldentif ier=0 

event= EVENT_MENU_SELECTION 
1-ToolkitRegistry . isEventSet is called 
at installation. 

Perform UICC initialization with the 
facility SET UP MENU and without the 
facilities SET EVENT LIST and POLL 
INTERVAL features 

2-Item Identifier = 1 

Event Menu Selection envelope is sent to 
the UICC with the item identifier of a 
menu entry of Appletl 



3-Item Identifier = 2 

Event Menu Selection envelope is sent to 
the UICC with the item identifier of a 
menu entry of Applet2 



1- The method must return true 



2- Appletl is triggered and Applet2 
is not triggered 



Appletl finalizes 

3- Applet2 is triggered and Appletl 
is not triggered 



5.5.3.4 EVENT_MENU_SELECTION_HELP_REQUEST 

Test Area Reference: Cre_Apt_Emsh. 
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5.5.3.4.1 



Conformance requirement 



5.5.3.4.1.1 



Normal execution 



CRRNl: If an ENVELOPE (MENU_SELECTION_HELP_SUPPORTED) command is received for one entry 
supporting help, then CAT Runtime Environment shall trigger the corresponding applet. 

CCRN2: A toolkit applet shall be triggered by the EVENT_MENU_SELECTION_HELP_REQUEST event 
only if the Menu Id corresponding to the Envelope Menu Selection Help Request received by the CAT 
Runtime Environment was registered with the helpSupported value set to true. 

CCRN3: If at least one menuld of a Toolkit Applet registers to 

EVENT_MENU_SELECTION_HELP_REQUEST, the SET UP MENU proactive command sent by the CAT 
Runtime Environment shall indicate to the ME that help information is available unless all the menus entries 
that support help are disabled. 



5.5.3.4.1.2 

No requirements. 

5.5.3.4.1.3 

No requirements. 

5.5.3.4.2 

Test Source: 
Test Applet: 



Cap File: 
5.5.3.4.3 



Parameter errors 
Context errors 
Test area files 

Test_Cre_Apt_Emsh.j ava. 
Cre_Apt_Emsh_l .Java. 
Cre_Apt_Emsh_2.j ava. 
Cre_Apt_Emsh_3 .j ava. 
cre_apt_emsh.cap. 

Test coverage 



CRR Number 


Test Case Number 


CRRN1 


1 


CRRN2 


1 


CRRN3 


2 
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5.5.3.4.4 



Test procedure 



Id 



Description 



API/CAT RE Expectation 



APDU Expectation 



Applet registration to 

EVENT_MENU_SELECTION_HELP_REQUEST 

and triggering 

Appletl and Applet2 are installed 

ToolkitRegistry . InitMenuEntry ( ) method is 
called at the installation of Appletl and 
Applet2 

For Appletl (item id 1) : 
MenuEntry=" Appletl A" 
Offset=0 

Length=menuEntry . length 
HelpSupported=true 
IconQualif ier=0 
Iconldentif ier=0 

For Appletl (item id 2) : 
MenuEntry=" Applet IB" 
Offset=0 

Length=menuEntry . length 
HelpSupported= false 
IconQualif ier=0 
Iconldentif ier=0 

event= EVENT_MENU_SELECTION_HELP_REQUEST 

1- ToolkitRegistry . isEventSet is called 
at the installation 

For Applet2 (item id 3) : 
MenuEntry="Applet2A" 
Offset=0 

Length=menuEntry . length 
HelpSupported=true 
IconQualif ier=0 
Iconldentif ier=0 

For Applet2 (item id 4) : 
MenuEntry=" Applet 2B" 
Offset=0 

Length=menuEntry . length 
HelpSupported=f alse 
IconQualif ier=0 
Iconldentif ier=0 

event= EVENT_MENU_SELECTION_HELP_REQUEST 

2- ToolkitRegistry . isEventSet is called 
at installation 

Perform UICC initialization with the 
facility SET UP MENU and without the 
facilities SET EVENT LIST and POLL 
INTERVAL 

3-Item identifier = 1 

Menu Selection Help Request envelope is 
sent to the UICC with item identifier 1 
belonging to Appletl 

4-Item identifier = 2 

Menu Selection Help Request envelope is 
sent to the UICC with item identifier 2 
belonging to Appletl 

5-Item identifier = 3 

Menu Selection Help Request envelope is 
sent to the UICC with item identifier 3 
belonging to Applet2 

6-Item identifier = 4 

Menu Selection Help Request envelope is 
sent to the UICC with item identifier 4 
belonging to Applet2 



1- The command shall return true 



2- The command shall return true 



3- Appletl is triggered and Applet2 
is not triggered 



4 Appletl and Applet2 are not 
triggered 



5- Applet2 is triggered and Appletl 
is not triggered 



6- Applet2 and Appletl are not 
triggered 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


2 


Applet deregistration to 
EVENT_MENU_SELECTION_HELP_REQUEST 

Appletl and Applet2 are deleted 

Applets is installed 

ToolkitRegistry . InitMenuEntry ( ) method is 
called at the installation of Applets 

For Applets (item id 5) : 
MenuEntry=" Applet 3A" 
Offset=0 

Length=menuEntry . length 
HelpSupported=true 
IconQualif ier=0 
Iconldentif ier=0 

For Applets (item id 6) : 
MenuEntry=" Applet 3B" 
Offset=0 

Length=menuEntry . length 
HelpSupported=true 
IconQualif ier=0 
Iconldentif ier=0 

For Applets (item id 7) : 
MenuEntry=" Applet 3C" 
Offset=0 

Length=menuEntry . length 
HelpSupported= false 
IconQualif ier=0 
Iconldentif ier=0 




1- The UICC shall issue a 




1- Perform UICC initialization with the 




SET UP MENU proactive 




facility SET UP MENU and without the 
facilities SET EVENT LIST and POLL 
INTERVAL 




command with Menu Entry 
ID entry '05', '06' and '07', 
and Help supported set to 
true. 




2- Menu Selection Help Request envelope is 


2- Applets is triggered by 






sent to the UICC with item identifier 5 


EVENT MENU SELECTION HEL 






belonging to applets 


P_REQUEST 






3- ToolkitRegistry .disableMenuEntry () 
method for item id 5 is called by the Menu 
Selection Help Request Envelope. 




3- The UICC shall issue a 
SET UP MENU proactive 
command with Menu Entry 
ID entry '06' and '07', and 
Help supported set to true. 




4- Menu Selection Help Request envelope is 
sent to the UICC with item identifier 6 
belonging to applets 


4- Applets is triggered by 

EVENT MENU SELECTION HEL 

P REOUEST 






5- ToolkitRegistry .disableMenuEntry () 
method for item id 6 is called by the Menu 




5- The UICC shall issue a 




Selection Help Request Envelope 




SET UP MENU proactive 
command with Menu Entry 
ID entry '07', and Help 
supported set to false 
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5.5.3.5 EVENT_CALL_CONTROL_BY_NAA 

Test Area Reference: Cre_Apt_Eccn. 

5.5.3.5.1 Conformance requirement 

5.5.3.5.1.1 Normal execution 

• CRRN 1 : The applet is triggered by the EVENT_CALL_CONTROL_B Y_N AA once it has registered to this 
event and an Envelope Call Control by NAA is received. 

• CRRN2: The applet is not triggered by the EVENT_CALL_CONTROL_BY_NAA once it has deregistered 
from this event. 

• CRRN3: Regardless of the Toolkit Applet state the CAT Runtime Environment shall not allow more than one 
Toolkit Applet to be registered to this event at a time. 



5.5.3.5.1.2 

No requirements. 

5.5.3.5.1.3 

No requirements. 

5.5.3.5.2 

Test Source: 
Test Applet: 

Cap File: 
5.5.3.5.3 



Parameter errors 
Context errors 
Test area files 

Test_Cre_APT_ECCN.java. 
Cre_Apt_Eccn_l .Java. 
Cre_Apt_Eccn_2.j ava. 
cre_apt_eccn.cap. 

Test coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2,3 


CRRN2 


3 


CRRN3 


See API 2 TKR SEVTB 



5.5.3.5.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Applets registration to 

EVENT_CALL_CONTROL_BY_NAA and 

triggering 

Appletl is registered to 
EVENT_CALL_CONTROL_BY_NAA . 

Applet2 is registered to 
EVENT_MENU_SELECTION 

1- An Envelope Call control by NAA is sent 
to the UICC 


1- Appletl is triggered 




2 


Applet deregistration and registration of the 

second applet to 

EVENT_CALL_CONTROL_BY_NAA. 

1- An Envelope menu selection is sent to 
the UICC 


1 - Applet2 is triggered by 
EVENT_IVIENU_SELECTION. 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 




Applet2 contructs a Display Text proactive 
command. 

2- ProactiveHandler . send ( ) method is 
called 

3- An Envelope Call control by NAA 
envelope is sent to the UICC 

ToolkitRegistry . clearEvent is called for 
EVENT_CALL_CONTROL_BY_NAA 

4- TERMINAL RESPONSE of Display Text is 
sent to the UICC 

ToolkitRegistry . setEvent ( ) method is 
called for EVENT_CALL_CONTROL_BY_NAA 


3- Appletl is triggered 

Appletl finalizes. 

4- Applet2 is resumed 

Applet2 finalizes 


2- A proactive command 
Display Text is sent and 
applet is suspended until 
the terminal response 


3 


Applet triggering 

An Envelope Call control by NAA envelope 
is sent to the UICC 


Applet2 is triggered. 
(Appletl is not triggered) 





5.5.3.6 EVENT_TIMER_EXPIRATION 

Test Area Reference: Cre_Apt_Etex. 

5.5.3.6.1 Conformance requirement 

5.5.3.6.1.1 Normal execution 

• CRRNl : The applet is triggered by the EVENT_TIMER_EXPIRATION once it has been registered to this 
event and an Envelope Timer Expiration with a Timer Identifier of the applet is received if no proactive 
session is ongoing. 

• CRRN2: The applet is not triggered by the EVENT_TIMER_EXPIRATION once it has been deregistered 
from this event. 



5.5.3.6.1.2 

No requirements. 

5.5.3.6.1.3 

No requirements. 

5.5.3.6.2 

Test Source: 
Test Applet: 
Cap File: 



Parameter errors 
Context errors 
Test area files 

Test_Cre_Apt_Etex.j ava 
Cre_Apt_Etex_ 1 .j ava 
cre_apt_etex. cap 
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5.5.3.6.3 



Test coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


2 



5.5.3.6.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Applet registration to 

EVENT_TIMER_EXPIRATION and 

triggering 

Applet is registered to the 
EVENT_TIMER_EXPIRATION using the 
allocateTimer method and to 

EVENT_MENU_SELECTION . 

event= EVENT_TIMER_EXPIRATION 

1- ToolkitRegistry .isEventSet 
method is called. 

2- An Envelope TIMER_EXPIRATION is 
sent to the UICC. 


1- The method returns true 

2- Applet is triggered. 




2 


Applet deregistration 

Timer id=l 

ToolkitRegistry . ReleaseTimer () method 

is called 

1- An Envelope timer expiration is 
sent to the UICC 

An Envelope Menu selection is sent to 
the UICC 

ToolkitRegistry .AllocateTimer () 
method is called 

2- An Envelope TIMER_EXPIRATION is 
sent to the UICC 


1- Applet is not triggered 

2- Applet is triggered 





5.5.3.7 EVENT_EVENT_DOWNLOAD_MT_CALL 

Test Area Reference: Cre_Apt_Edmc. 

5.5.3.7.1 Conformance requirement 

5.5.3.7.1.1 Normal execution 

• CRRNl : The applet is triggered by the EVENT_EVENT_DOWNLOAD_MT_CALL once it has registered to 
this event and an Envelope Event DownLoad MT Call is received. 

• CRRN2: The applet is not triggered by the EVENT_EVENT_DOWNLOAD_MT_CALL once it has 
deregistered from this event. 



5.5.3.7.1.2 

No requirements. 

5.5.3.7.1.3 

No requirements. 



Parameter errors 



Context errors 
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5.5.3.7.2 

Test Source: 
Test Applet: 
Cap File: 

5.5.3.7.3 



Test area files 

Test_Cre_Apt_Edmc.j ava. 
Cre_Apt_Edmc_l .Java. 
cre_apt_edmc . c ap . 

Test coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


2 



5.5.3.7.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Applet registration to 

EVENT_EVENT_DOWNLOAD_MT_CALL and 

triggering 

Applet is registered to the 
EVENT_EVENT_DOWNLOAD_MT_CALL and to 
EVENT_MENU_SELECTION 

event= EVENT_EVENT_DOWNLOAD_MT_CALL 
1-ToolkitRegistry .isEventSet method is 
called 

2-An Envelope EVENT_DOWNLOAD_MT_CALL is 
sent to the UICC 


1- The method returns true 

2- Applet is triggered 




2 


Applet deregistration 

event= EVENT_EVENT_DOWNLOAD_MT_CALL 
ToolkitRegistry . clearEvent Omethod is 
called 

1-An Envelope EVENT_DOWNLOAD_MT_CALL is 
sent to the UICC 

An Envelope menu selestion is sent to the 
UICC 

event= EVENT„EVENT_DOWNLOAD_MT_CALL 
ToolkitRegistry . setEvent ( ) method is 
called 

2-An Envelope EVENT_DOWNLOAD_MT_CALL is 
sent to the UICC 


1- Applet is not triggered 

2- Applet is triggered 





5.5.3.8 EVENT_EVENT_DOWNLOAD_CALL_CONNECTED 

Test Area Reference: Cre_Apt_Edcc. 



5.5.3.8.1 



5.5.3.8.1.1 



Conformance requirement 
Normal execution 



CRRNl: The applet is triggered by the EVENT_EVENT_DOWNLOAD_CALL_CONNECTED once it has 
registered to this event and an Envelope Event DownLoad Call Connected is received. 

CRRN2: The applet is not triggered by the EVENT_EVENT_DOWNLOAD_CALL_CONNECTED once it 
has deregistered from this event. 
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5.5.3.8.1.2 

No requirements. 

5.5.3.8.1.3 

No requirements. 

5.5.3.8.2 

Test Source: 
Test Applet: 
Cap File: 

5.5.3.8.3 



Parameter errors 
Context errors 
Test area files 

Test_Cre_Apt_Edcc.j ava. 
Cre_Apt_Edcc_ 1 .j ava. 
cre_apt_edcc.cap. 

Test coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


2 



5.5.3.8.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Applet registration to 

EVENT_EVENT_DOWNLOAD_CALL_CONNECT 

ED and triggering 

Applet is registered to the 

EVENT_EVENT_DOWNLOAD_CALL_CONNECTED and to 
EVENT_MENU_SELECTION 

event= EVENT_EVENT_DOWNLOAD_CALL_CONNECTED 
1-ToolkitRegistry . isEventSet {) method is 
called 

2-An Envelope 

EVENT_DOWNLOAD_CALL_CONNECTED is sent to 
the UICC 


1- Method returns true 

2- Applet is triggered 




2 


Applet deregistration 

event=EVENT_EVENT_DOWNLOAD_CALL_CONNECTED 
ToolkitRegistry . clear Event ( ) method is 
called 

1-A call connected event dowload is sent 
to the UICC 

An Envelope menu selection is sent to the 
UICC 

Event= EVENT_EVENT_DOWNLOAD_CALL_CONNECTED 
ToolkitRegistry . setEvent ( ) method is 
called 

2-An Envelope 

EVENT_DOWNLOAD_CALL_CONNECTED is sent to 
the UICC 


1- Applet is not triggered 

2- Applet is triggered 
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5.5.3.9 EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED 

Test Area Reference: Cre_Apt_Edcd. 

5.5.3.9.1 Conformance requirement 

5.5.3.9.1.1 Normal execution 

• CRRN 1 : The applet is triggered by the EVENT_EVENT_DOWNLO AD_C ALL_DISCONNECTED once it 
has registered to this event and an Envelope Event DownLoad Call Disconnected is received. 

• CRRN2: The applet is not triggered by the EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED once 
it has deregistered from this event. 



5.5.3.9.1.2 

No requirements. 

5.5.3.9.1.3 

No requirements. 

5.5.3.9.2 

Test Source: 
Test Applet: 
Cap File: 

5.5.3.9.3 



Parameter errors 
Context errors 
Test area files 

Test_Cre_Apt_Edcd.j ava. 
Cre_Apt_Edcd_ 1 .j ava. 
cre_apt_edcd.cap. 

Test coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


2 



5.5.3.9.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Applet registration to 

EVENT_EVENT_DOWNLOAD_CALL_DISCONN 

ECTED and triggering 

Applet is registered to the 

EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED and 
to EVENT_MENU_SELECTION 

Event=EVENT_EVENT_DOWNLOAD_CALL_DISCONNECT 

ED 

1-ToolkitRegistry . isEventSet method is 

called 

2-An Envelope 

EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED is 
sent to the UICC 


1- Method retums true 

2- Applet is triggered 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


2 


Applet deregistration 

Event= 

EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED 
ToolkitRegistry . clear Event () method is 
called 

1-An Envelope 

EVENT_DOWNLOAD_CALL_DISCONNECTED is sent 
to the UICC 

An envelope menu selection is sent to the 
UICC 

Event= 

EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED 
ToolkitRegistry . setEvent ( ) method is 
called 

2-An Envelope 

EVENT_EVENT„DOWNLOAD_CALL_DISCONNECTED is 
sent to the UICC 


1 - Applet is not triggered 
2- Applet is triggered 





5.5.3.1 EVENT_EVENT_DOWNLOAD_LOCATION_STATUS 

Test Area Reference: Cre_Apt_Edls. 

5.5.3.10.1 Conformance requirement 

5.5.3.10.1.1 Normal execution 

• CRRN 1 : The applet is triggered by the EVENT_EVENT_DOWNLO AD_LOC ATION_STATUS once it has 
registered to this event and an Envelope Event DownLoad Location Status is received. 

• CRRN2: The applet is not triggered by the EVENT_EVENT_DOWNLOAD_LOCATION_STATUS once it 
has deregistered from this event. 



5.5.3.10.1.2 
No requirements. 

5.5.3.10.1.3 
No requirements. 

5.5.3.10.2 

Test Source: 
Test Applet: 
Cap File: 

5.5.3.10.3 



Parameter errors 
Context errors 
Test area files 

Test_Cre_Apt_Edls.java. 
Cre_Apt_Edls_ 1 .j ava. 
cre_apt_edl s .c ap . 

Test coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


2 
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5.5.3.10.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Applet registration to 

EVENT_EVENT_DOWNLOAD_LOACTION_STA 

TUS and triggering 

Applet is registered to the 

EVENT_EVENT_DOWNLOAD_LOCATION_STATUS and 
to EVENT_MENU_SELECTION 

Event=EVENT_EVENT_DOWNLOAD_LOCATION_STATUS 
1-ToolkitRegistry . isEventSet method is 
called 

2 -An Envelope 

EVENT_EVENT_DOWNLOAD_LOCAT I ON_S TATUS 1 s 
sent to the UICC 


1- Method returns true 

2- Applet is triggered 




2 


Applet deregistration 

Event =EVENT_EVENT_DOWNLOAD_LOCAT I ON_S TATUS 
ToolkitRegistry . clearEvent Omethod is 
called 

1-An Envelope 

EVENT_DOWNLOAD_LOCATION_STATUS is sent to 
the UICC 

An Envelope menu selection is sent to the 
UICC 

Event= 

EVENT_EVENT_DOWNLOAD_LOCAT I ON_S TATUS 
ToolkitRegistry . setEvent method is 
called 

2-An Envelope 

EVENT_DOWNLOAD_LOCATION_STATUS is sent to 
the UICC 


1- Applet is not triggered 

2- Applet is triggered 





5.5.3.1 1 EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 

Test Area Reference: Cre_Apt_Edua 

5.5.3.1 1.1 Conformance requirement 

5.5.3.11.1.1 Normal execution 

• CRRN 1 : The applet is triggered by the EVENT_EVENT_DOWNLO AD_USER_ACTIVITY once it has 
registered to this event and an Envelope Event DownLoad User Activity is received. 

• CRRN2: The applet is not triggered by the EVENT_EVENT_DOWNLOAD_USER_ACTIVITY once it has 
deregistered from this event. 



5.5.3.11.1.2 
No requirements. 

5.5.3.11.1.3 
No requirements. 

5.5.3.11.2 

Test Source: 
Test Applet: 



Parameter errors 
Context errors 
Test area files 

Test_Cre_Apt_Edua.j ava. 
Cre_Apt_Edua_ 1 .j ava. 
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Cap File: 
5.5.3.11.3 



cre_apt_edua . c ap . 



Test coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


2 



5.5.3.11.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Applet registration to 

EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 

and triggering 

Applet is registered to the 

EVENT_EVENT_DOWNLOAD_USER_ACTIVITY and to 
EVENT_MENU_SELECTION 

Event= EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 

1-ToolkitRegistry .isEventSet method is 
called 

2-An Envelope EVENT_DOWNLOAD_USER_ACTIVITY 
is sent to the UICC 


1- Method returns true 

2- Applet is triggered 




2 


Applet dereglstration 

Event= EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 
ToolkitRegistry . clearEvent Omethod is 
called 

1-An Envelope EVENT_DOWNLOAD_USER_ACTIVITY 
is sent to the UICC 

An Envelope menu selection is sent to the 
UICC 

Event= EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 
ToolkitRegistry . setEvent ( ) method is 
called 

2-An Envelope EVENT_DOWNLOAD_USER_ACTIVITY 
is sent to the UICC 


1- Applet is not triggered 

2- Applet is triggered 





5.5.3.12 EVENT_EVENT_DOWNLOADJDLE_SCREEN_AVAILABLE 

Test Area Reference: Cre_Apt_Edis 

5.5.3.12.1 Conformance requirement 

5.5.3.12.1.1 Normal execution 

• CRRN 1 : The applet is triggered by the EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE 
once it has registered to this event and an Envelope Event DownLoad Idle Screen Available is received. 

• CRRN2: The applet is not triggered by the EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE 
once it has deregistered from this event. 



5.5.3.12.1.2 
No requirements. 



Parameter errors 
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5.5.3.12.1.3 
No requirements. 

5.5.3.12.2 

Test Source: 
Test Applet: 
Cap File: 

5.5.3.12.3 



Context errors 
Test area files 

Test_Cre_Apt_Edis.java. 
Cre_Apt_Edis_ 1 .j ava. 
cre_apt_edi s . c ap . 

Test coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


2 



5.5.3.12.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Applet registration to 

EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_ 

AVAILABLE and triggering 

Applet is registered to the 

EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE 

and to EVENT_MENU_SELECTION 

Event= 

EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE 

1-ToolkitRegistry . isEventSet method is 

called 

2- An Envelope 

EVENT„DOWNLOAD„IDLE„SCREEN__AVAILABLE is 
sent to the UICC 


1- Method returns true 

2- Applet is triggered 




2 


Applet dereglstration 

Event=EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVA 
ILABLE 

ToolkitRegistry . clear Event () method is 
called 

1- An Envelope 

EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE is 
sent to the UICC 

An Envelope menu selection is sent to the 
UICC 

Event= 
EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE 

ToolkitRegistry . setEvent ( ) method is 
called 

2-An Envelope 

EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE is 
sent to the UICC 


1- Applet is not triggered 

2- Applet is triggered 
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5.5.3.13 EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS 

Test Area Reference: Cre_Apt_Edcr. 

5.5.3.13.1 Conformance requirement 

5.5.3.13.1.1 Normal execution 

• CRRN 1 : The applet is triggered by the EVENT_EVENT_DOWNLO AD_C ARD_READER_STATUS once it 
has registered to this event and Envelope Event DownLoad Card Reader Status is received. 

• CRRN2: The applet is not triggered by the EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS 
once it has deregistered from this event. 



5.5.3.13.1.2 
No requirements. 

5.5.3.13.1.3 
No requirements. 

5.5.3.13.2 

Test Source: 
Test Applet: 
Cap File: 

5.5.3.13.3 



Parameter errors 
Context errors 
Test area files 

Test_Cre_Apt_Edcr.j ava. 
Cre_Apt_Edcr_ 1 .j ava. 
cre_apt_edcr.cap. 

Test coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


2 



5.5.3.13.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Applet registration to 

EVENT_EVENT_DOWNLOAD_CARD_READER 

_STATUS and triggering 

Applet is registered to the 
EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS 
and to EVENT_MENU_SELECTION 

Event=EVENT_EVENT_DOWNLOAD_CARD_READER_STA 

TUS 

1-ToolkitRegistry . isEventSet method is 

called. 

2- An Envelope 

EVENT_DOWNLOAD_CARD_READER_STATUS is sent 
to the UICC 


1- Method retums true 

2- Applet Is triggered 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


2 


Applet deregistration 

Event= 

EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS 

ToolkitRegistry . clear Event () method is 
called 








1-An Envelope 

EVENT_DOWNLOAD_CARD_READER_STATUS is sent 
to the UICC 


1- Applet is not triggered 






An Envelope menu selection is sent to the 
UICC 








Event= 
EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS 








ToolkitRegistry . setEvent ( ) method is 
called 








2-An Envelope 

EVENT_DOWNLOAD_CARD_READER_STATUS is sent 
to the UICC 


2- Applet is triggered 





5.5.3.14 EVENT_UNRECOGNIZED_ENVELOPE 

Test Area Reference: Cre_Apt_Euev. 

5.5.3.14.1 Conformance requirement 

5.5.3.14.1.1 Normal execution 

• CRRN 1 : The applet is triggered by the EVENT_UNRECOGNIZED_EN VELOPE once it has registered to this 
event and an Unrecognized Envelope is received. 

• CRRN2: The applet is not triggered by the EVENT_UNRECOGNIZED_ENVELOPE once it has deregistered 
from this event. 



5.5.3.14.1.2 
No requirements. 

5.5.3.14.1.3 
No requirements. 

5.5.3.14.2 

Test Source: 
Test Applet: 
Cap File: 

5.5.3.14.3 



Parameter errors 
Context errors 
Test area files 

Test_Cre_Apt_Euen.j ava. 
Cre_Apt_Euen_ 1 .j ava. 
cre_apt_euen.cap. 

Test coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


2 
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5.5.3.14.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Applet registration to 

EVENT_UNRECOGNIZED_ENVELOPE and 

triggering 

Applet is registered to the 
EVENT_UNRECOGNIZED_ENVELOPE 
Event= EVENT_UNRECOGNIZED_ENVELOPE 
1-ToolkitRegistry . isEventSet method is 

called 

2-An Envelope UNRECOGNIZED_ENVELOPE is 
sent to the UICC 


1- Method returns true 

2- Applet is triggered 




2 


Applet deregistration 

Event= EVENT_UNRECOGNIZED_ENVELOPE 
ToolkitRegistry . clear Event () method is 
called 

1-An Envelope UNRECOGNIZED_ENVELOPE is 
sent to the UICC 

An Envelope menu selection is sent to the 
Dice 

Event= EVENT_UNRECOGNIZED_ENVELOPE 
ToolkitRegistry . setEvent method is 

called 

2-An Envelope UNRECOGNIZED_ENVELOPE is 
sent to the UICC 


1- Applet is not triggered 

2- Applet is triggered 





5.5.3.15 EVENT_STATUS_COMMAND 

Test Area Reference: Cre_Apt_Estc. 

5.5.3.15.1 Conformance requirement 

5.5.3.15.1.1 Normal execution 

• CRRN 1 : The applet is triggered by the EVENT_STATUS_COMM AND once it has registered to this event 
and a Status Command is received. 

• CRRN2: The applet is not triggered by the EVENT_STATUS_COMMAND once it has deregistered from this 
event. 



5.5.3.15.1.2 
No requirements. 

5.5.3.15.1.3 
No requirements. 

5.5.3.15.2 

Test Source: 
Test Applet: 



Parameter errors 
Context errors 
Test area files 

Test_Cre_Apt_Estc.j ava. 
Cre_ Apt_Es tc_ 1 .j a va . 
Cre_Apt_Estc_2.java. 
Cre_Apt_Estc_3 .j ava. 
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Cap File: 
5.5.3.15.3 



cre_apt_estc.cap. 

Test coverage 



CR Number 


Test Case Number 


CRRN1 


1,2,3 


CRRN2 


3 



5.5.3.15.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Applets registration to 
EVENT_STATUS_COMMAND and triggering 

Appletl is registered to 
EVENT_STATUS_COMMAND using the 
requestPollInterval command 

Applet2 is registered to 
EVENT_STATUS_COMMAND using the 
RequestPollInterval command 

Applets is registered to 

EVENT_MENU_SELECTION . 








1-A status command is sent to UICC 


1- Appletl is triggered. 
Appletl finalizes 

2- Applet2 is triggered. 
Applet2 finalizes 

3- Applets is not triggered 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


2 


Applet dereglstration and registration of the 
third applet to EVENT_STATUS_COMMAND. 

1- An Envelope menu selection is sent to 
UICC 

Applets builds a Display Text. 

2- ProactiveHandler . send is called 

3- A status command is sent to UICC 

4- requestPollInterval ( ) method with 
POLL_NO_DURATION is called 

5- requestPollInterval method with 
POLL_NO_DURATION is called 

6- TERMINAL RESPONSE of Display Text is 
sent to the UICC 

7- requestPollInterval method is called 


1- Applets is triggered. 

3- Appletl is triggered. 

4- Appletl is deregistered to 
EVENT_STATUS_COMMAND 

Appletl finalizes 
Applet2 is triggered. 

5- Applet2 is deregistered to 
EVENT_STATUS_COMMAND 

Applet2 finalizes 

6- Applets is resumed 

7- Applets is registered to 
EVENT_STATUS_COMMAND 

Applets finalizes 


2- A proactive command 
Display Text is sent and 
applet is suspended until 
the terminal response 


3 


Applet3 triggering 

status command is sent to UICC 


Applets is triggered. 
(Appletl and Applet2 are not 
triggered) 





5.5.3.16 EVENT_EVENT_DOWNLOAD_LANGUAGE_SELECTION 

Test Area Reference: Cre_Apt_Edlg. 

5.5.3.16.1 Conformance requirement 

5.5.3.16.1.1 Normal execution 

• CRRN 1 : The applet is triggered by the EVENT_EVENT_DOWNLO AD_LANGU AGE_SELECTION once it 
has registered to this event and an Envelope Event DownLoad Language Selection is received. 

• CRRN2: The applet is not triggered by the EVENT_EVENT_DOWNLOAD_LANGUAGE_SELECTION 
once it has deregistered from this event. 



5.5.3.16.1.2 
No requirements. 

5.5.3.16.1.3 
No requirements. 



Parameter errors 



Context errors 



ETSI 



Release 6 



635 



ETSI TS 102 268 V6.0.0 (2007-03) 



5.5.3.16.2 

Test Source: 
Test Applet: 
Cap File: 

5.5.3.16.3 



Test area files 

Test_Cre_Apt_Edlg.j ava. 
Cre_ Apt_Edlg_ 1 .j a va . 
cre_apt_edlg . c ap . 

Test coverage 



CR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


2 



5.5.3.16.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Applet registration to 

EVENT_EVENT_DOWNLOAD_LANGUAGE_SE 

LECTION and triggering 

Applet is registered to the 
EVENT_EVENT_DOWNLOAD_LANGUAGE_SELECTION 
and to EVENT_MENU_SELECTION. 

Event= 
EVENT_EVENT_DOWNLOAD_LANGUAGE_SELECTION 

1-ToolkitRegistry . isEventSet method is 
called 

2-An Envelope 

EVENT_DOWNLOAD_LANGUAGE_SELECTION is sent 
to the UICC 


1 -Method returns true 
2- Applet is triggered 




2 


Applet deregistration 

Event= 

EVENT_EVENT_DOWNLOAD_LANGUAGE_SELECTION 
ToolkitRegistry . clear Event () method is 
called 

1-An Envelope 

EVENT_DOWNLOAD_LANGUAGE_SELECTION is sent 
to the UICC 

An Envelope menu selection is sent to the 
UICC 

Event= 

EVENT_EVENT_DOWNLOAD_LANGUAGE_SELECTION 
ToolkitRegistry . setEvent ( ) method is 
called 

2-An Envelope 

EVENT_DOWNLOAD_LANGUAGE_SELECTION is sent 
to the UICC 


1- Applet Is not triggered 

2- Applet is triggered 
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5.5.3.17 EVENT_EVENT_DOWNLOAD_BROWSER_TERMINATION 

Test Area Reference: Cre_Apt_Edbt. 

5.5.3.17.1 Conformance requirement 

5.5.3.17.1.1 Normal execution 

• CRRN 1 : The applet is triggered by the EVENT_EVENT_DOWNLO AD_BROWSER_TERMINATION once 
it has registered to this event and an Envelope Event DownLoad Browser Termination is received. 

• CRRN2: The applet is not triggered by the EVENT_EVENT_DOWNLOAD_BROWSER_TERMINATION 
once it has deregistered from this event. 



5.5.3.17.1.2 
No requirements. 

5.5.3.17.1.3 
No requirements. 

5.5.3.17.2 

Test Source: 
Test Applet: 
Cap File: 

5.5.3.17.3 



Parameter errors 
Context errors 
Test area files 

Test_Cre_Apt_Edbt.j ava. 
Cre_Apt_Edbt_ 1 .j ava. 
cre_apt_edbt.cap. 

Test coverage 



CR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


2 



5.5.3.17.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Applet registration to 

EVENT EVENT DOWNLOAD 

BROWSER_TERMINATION and triggering 

Applet is registered to the 
EVENT_EVENT_DOWNLOAD_BROWSER_TERMINATION 
and to EVENT_MENU_SELECTION 

Event= 
EVENT_EVENT_DOWNLOAD_BROWSER_TERMINATION 

1-ToolkitRegistry . isEventSet method is 

called 

2-An Envelope 

EVENT_DOWNLOAD_BROWSER_TERMINATION is sent 
to the UICC 


1 -Method returns true 
2- Applet is triggered 




2 


Applet dereglstration 

Event= 

EVENT_EVENT_DOWNLOAD_BROWSER_TERMINATION 
ToolkitRegistry . clear Event ( ) method is 
called 

1-An Envelope 


1- Applet is not triggered 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 




EVENT_DOWNLOAD_BROWSER_TERMINATION is sent 
to the UICC 

An Envelope menu selection is sent to the 
UICC 

Event= 

EVENT_EVENT_DOWNLOAD_BROWSER_TERMINATION 
ToolkitRegistry . setEvent method is 

called 

2-An Envelope 

EVENT_DOWNLOAD_BROWSER_TERMINATION is sent 
to the UICC 


2- Applet is triggered 





5.5.3.1 8 EVENT_FIRST_COMMAND_AFTER_ATR 

Test Area Reference: Cre_Apt_Efca. 

5.5.3.18.1 Conformance requirement 

5.5.3.18.1.1 Normal execution 

• CRRN 1 : The applet is triggered by the EVENT_FIRST_COMMAND_AFTER_ATR once it has registered to 
this event and upon the reception of the first APDU after the ATR, before the Status Word of the processed 
command has been sent back by the UICC. 

• CRRN2: The applet is not triggered by the EVENT_FIRST_COMMAND_AFTER_ATR once it has 
deregistered from this event. 

• CRRN3: If the first APDU received is a toolkit applet triggering APDU (e.g. TERMINAL PROFILE), the 
toolkit applets registered to the EVENT_FIRST_COMMAND_AFTER_ATR event shall be triggered first. 



5.5.3.18.1.2 
No requirements. 

5.5.3.18.1.3 
No requirements. 

5.5.3.18.2 

Test Source: 
Test Applet: 



Cap File: 



Parameter errors 
Context errors 
Test area files 

Test_Cre_Apt_Efca.j ava. 
Cre_Apt_Efca_l .Java. 
Cre_Apt_Efca_2.java. 
Cre_Apt_Efca_3 .j ava. 
Cre_Apt_Efca_4.j ava. 
Cre_Apt_Efca_5 .j ava. 
cre_apt_efca.cap. 
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5.5.3.18.3 



Test coverage 



CR Number 


Test Case Number 


CRRN1 


1,2,3,4 


CRRN2 


3 


CRRN3 


1,4 



5.5.3.18.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Applets registration to 

EVENT_FIRST_COMMAND_AFTER_ATRand 

triggering 

Appletl is registered to the 
EVENT_FIRST_COI«AND_AFTER_ATR 

Applet2 is registered to the 
EVENT_PROFILE_DOWNLOAD 

Applets is registered to 
EVENT_MENU_SELECTION 








1- Terminal Profile command is sent to the 
UICC 


1- Appletl is triggered by 

EVENT FIRST COMMAND AFTE 






2- Appletl deregisters from 


R_ATR 






EVENT_FIRST_COMMAND_AFTER_ATR 








3- Applet2 deregisters from 


Appletl finalizes 

Applet2 is triggered by 

EVENT_PROFILE_DOWNLOAD 






EVENT_PROFILE_DOWNLOAD 


Applet2 finalizes 
Applet3 is not triggered 






4- An Envelope menu selection is sent to 


4- Applet3 is triggered. 






the UICC 








5- Applets calls setEventO on event 








EVENT„FIRST_COMMAND__AFTER_ATR 






2 


Deregistered applets are not triggered 








l-Reset then Terminal Profile command is 
sent to the UICC 


1 -Applet3 is triggered 
Appletl and Applet2 are not 
triggered 






2-AppletS calls setEventO on 
EVENT_PROFILE„DOWNLOAD 


2-Applet3 finalizes 




3 


Install a 4'" applet registered to 

EVENT FIRST COMMAND AFTER ATR and 

EVENT_PROFILE_DOWNLOAD 

Applet4 is installed, with the same 
priority level as Applets 








l-Reset then Terminal Profile command is 
sent to the UICC 


1 - Applet4 is triggered by 

EVENT FIRST COMMAND AFTE 

R_ATR 

Applet4 finalizes 

Applet3 is triggered by 

EVENT FIRST COMMAND Ah 1 b 

R_ATR 

Applet3 finalizes 

Applet4 is triggered by 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 




2- Delete all applets 


EVENT_PROFILE DOWNLOAD 

Applet4 finalizes 

Applets is triggered by 
EVENT_PROFILE_DOWNLOAD 

Applets finalizes 




4 


Check that the applet is triggered before the 
first status word is sent 

1- Install Applets 

Applets is registered with two entries in 
the menu entries list 
Applets is also registered to 
EVENT_FIRST_COMMAND_AFTER_ATR 

2- Reset then Terminal Profile command is 
sent to the UICC 

3- Applets disables a menu entry 


2- Applets is triggered 


S-The SETUP MENU 

proactive command is 

fetched. 

There is only one item for 

Applets 



5.5.3.19 EVENT_EVENT_DOWNLOAD_DATA_AVAILABLE 

Test Area Reference: Cre_Apt_Edda. 

5.5.3.19.1 Conformance requirement 

5.5.3.19.1.1 Normal execution 

• CRRN 1 : For EVENT_EVENT_DOWNLOAD_D AT A_ AVAILABLE, the framework shall only trigger the 
applet registered to this event with the appropriate channel identifier. 

• CRRN2: The registration to the EVENT_EVENT_DOWNLOAD_DATA_AVAILABLE is effective once the 
toolkit applet has issued a successful OPEN CHANNEL proactive command, and valid till the first successful 
CLOSE CHANNEL or the end of card session. 

• CRRN3: When a Toolkit Applet has sent an OPEN CHANNEL proactive command and received a successful 
TERMINAL RESPONSE with General Result ="OxOX", the framework shall register the received channel 
identifier for the calling Toolkit Applet. 

• CRRN4: When a Toolkit Applet has sent a CLOSE CHANNEL proactive command and received a successful 
TERMINAL RESPONSE with General Result ="OxOX", the framework shall release the channel identifier 
contained in the command. 



5.5.3.19.1.2 
No requirements. 

5.5.3.19.1.3 
No requirements. 



Parameter errors 



Context errors 
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5.5.3.19.2 

Test Applet: 
Test Applet: 
Cap File: 

5.5.3.19.3 



Test area files 

Test_Cre_Apt_Edda.j ava. 
Cre_Apt_Edda_l .Java. 
cre_apt_edda.cap. 

Test coverage 



CR Number 


Test Case Number 


CRRN1 


2 


CRRN2 


1,4,5 


CRRN3 


1 


CRRN4 


3 
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5.5.3.19.4 



Test procedure 



Id 



Description 



API/CAT RE Expectation 



APDU Expectation 



Applet registration to 

EVENT_EVENT_DOWNLOAD_DATA_AVAILAB 

LE 



Appletl is registered to Event Menu 

selection. 

1- An Envelope menu selection is sent to 

the UICC 



2- Applet calls setEvent() with the event 
EVENT_EVENT_DOWNLOAD_DATA_AVAILABLE 

3- An envelope Event Download Data 
Available is sent to the UICC 
Channel Status = 81 00 

4- An Envelope menu selection is sent to 
the UICC 

5- Appletl builds a proactive command OPEN 
CHANNEL calling ProactiveHandler . init ( ) 
method 

6- sendO method is called to register to 

this event 



1 - Appletl is triggered by the 
envelope menu selection 



2- Appletl finalizes 

3- Appletl is not triggered 



4- Appletl is triggered by the 
envelope menu selection 



8- An envelope Event Download Data 
Available is sent to the UICC with Channel 
Status = 01 00 

9- An Envelope menu selection is sent to 

the UICC 

10- Appletl builds a proactive command 
OPEN CHANNEL calling 
ProactiveHandler . init ( ) method 

11- send() method is called to register to 
this event 



7- Appletl finalizes 

8- Appletl is not triggered 



9- Appletl is triggered by the 
envelope menu selection 



12- Appletl finalizes 



6- OPEN CHANNEL 
proactive command is 
fetched 

Unsuccessful TERMINAL 
RESPONSE of OPEN 
CHANNEL is sent to the 
UICC with General Result = 
0x10 



11- OPEN CHANNEL 
proactive command is 
fetched. 

Successful TERMINAL 
RESPONSE of OPEN 
CHANNEL is sent to the 
UICC with Channel Id = 01 
with General Result = 0x00 



Applet triggering to 

EVENT_EVENT_DOWNLOAD_DATA_AVAILAB 

LE 

1- An envelope Event Download Data 
Available is sent to the UICC 
Channel Status = 81 00 



1- Appletl is triggered 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


3 


Applet deregistration to EVENT EVENT 
DOWNLOAD_DATA_ AVAILABLE 








1- An Envelope menu selection is sent to 
the UICC 


1- Appletl is triggered 






2- Appletl initializes and sends an OPEN 
CHANNEL proactive command 




2- OPEN CHANNEL 
proactive command is 
fetched 

Successful terminal 
response is sent, with 
channelld=02 with General 
Result = 0x01 




3- Appletl builds a CLOSE CHANNEL 
Proactive Command calling 




3- CLOSE CHANNEL 




ProactiveHandler . initCloseChannel ( ) and 




proactive command is 




ProactiveHandler . send ( ) methods 




fetched 

Unsuccessful TERMINAL 
RESPONSE of CLOSE 
CHANNEL is sent to the 




4- An envelope Event Download Data 
Available is sent to the UICC 


4- Appletl is triggered 


UICC with General Result = 
0X20 




Channel Status = 82 00 








5- Appletl builds a CLOSE CHANNEL 




5- CLOSE CHANNEL 




Proactive Command calling 




proactive command is 




ProactiveHandler. InitCloseChannel ( ) and 




fetched 




ProactiveHandler . send ( ) methods. 


6- Appletl finalize 


Successful TERMINAL 
RESPONSE of CLOSE 
CHANNEL is sent to the 
UICC with Channel Id = 02 
with General Result = 0X02 


4 


Applet triggering to 

EVENT EVENT DOWNLOAD DATA AVAILAB 

LE 








1- An envelope Event Download Data 
Available is sent to the UICC 


1 - Appletl is not triggered 






Channel Status = 82 00 






5 


Appletl not triggered after a reset 

1- Appletl is triggered by an envelope 
menu selection 

2- Appletl builds a proactive command OPEN 
CHANNEL calling ProactiveHandler . init ( ) 
method 








3- send() method is called to register to 




3- OPEN CHANNEL 




this event 




proactive command is 

fetched 

Successful TERMINAL 

RESPONSE of OPEN 

CHANNEL is sent to the 

UICC with Channel Id = 02 




4- isEventSetO method is called 


4- returns true 


with General Result = 0X00 




5- Reset the card 








6- An envelope Event Download Data 
Available is sent to the UICC 


6- Appletl is not triggered 






Channel Status = 82 00 
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5.5.3.20 EVENT_EVENT_DOWNLOAD_CHANNEL_STATUS 

Test Area Reference: Cre_Apt_Edcs. 

5.5.3.20.1 Conformance requirement 

5.5.3.20.1.1 Normal execution 

• CRRN 1 ; For EVENT_EVENT_DOWNLOAD_CHANNEL_STATUS, the framework shall only trigger the 
applet registered to this event with the appropriate channel identifier. 

• CRRN2: The registration to the EVENT_EVENT_DOWNLOAD_CHANNEL_STATUS is effective once the 
toolkit applet has issued a successful OPEN CHANNEL proactive command, and valid till the first successful 
CLOSE CHANNEL or the end of the card session. 

• CRRN3: When a Toolkit Applet has sent an OPEN CHANNEL proactive command and received a successful 
TERMINAL RESPONSE, the framework shall register the received channel identifier for the calling Toolkit 
Applet. 

• CRRN4: When a Toolkit Applet has sent a CLOSE CHANNEL proactive command and received a successful 
TERMINAL RESPONSE, the framework shall release the channel identifier contained in the command. A 
successful TERMINAL RESPONSE means that the result of the proactive command execution belongs to 
command performed category (i.e. General Result ='0x'). 



5.5.3.20.1.2 
No requirements. 

5.5.3.20.1.3 
No requirements. 

5.5.3.20.2 

Test Source: 
Test Applet: 
Cap File: 

5.5.3.20.3 



Parameter errors 
Context errors 
Test area files 

Test_Cre_Apt_Edcs.java. 
Cre_Apt_Edcs_ 1 .j ava. 
cre_apt_edcs.cap. 

Test coverage 



CR Number 


Test Case Number 


CRRN1 


2 


CRRN2 


1,4,5 


CRRN3 


1 


CRRN4 


3 
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5.5.3.20.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Applet registration to 

EVENT EVENT DOWNLOAD CHANNEL STAT 

US 

Appletl is registered to Event Menu 
Selection 








1- An Envelope menu selection is sent to 

the UICC 


1 - Appletl is triggered by the 
envelope menu selection 






2-The applet calls setEventO with 








EVENT_EVENT_DOWNLOAD_CHANNEL_STATUS 


Appletl finalizes 






3- An envelope Event Download Channel 
Status is sent to the UICC 


3- Appletl is not triggered 






Channel Status = 81 00 








4- An Envelope menu selection is sent to 








the UICC 

5- Appletl builds a proactive command OPEN 


4- Appletl is triggered by the 
envelope menu selection 






CHANNEL calling ProactiveHandler . init ( ) 








method 








6- sendO method is called to register to 

this event 


7- Applet finalizes 


6- OPEN CHANNEL 
proactive command is 
fetched 

Unsuccessful TERIVIINAL 
RESPONSE of OPEN 
CHANNEL is sent to the 
UICC with General Result = 
0x10 




8- An envelope Event Download Data 
Available is sent to the UICC with Channel 


8- Appletl is not triggered 






Status = 01 00 








9- An Envelope menu selection is sent to 

the UICC 


9- Appletl is triggered by the 
envelope menu selection 






10- Appletl builds a proactive command 








OPEN CHANNEL calling 








ProactiveHandler . init ( ) method 




11- OPEN CHANNEL 




11- send() method is called to register to 
this event a second time 


12- Appletl finalizes 


proactive command is 

fetched 

Successful TERMINAL 

RESPONSE of OPEN 

CHANNEL is sent to the 

UICC with Channel Id = 01 

with General Result = 0x00 


2 


Applet triggering to 

EVENT EVENT DOWNLOAD CHANNEL 

STATUS 








1- An envelope Event Download Channel 
Status is sent to the UICC 


1- Appletl is triggered 






Channel Status = 81 00 






3 


Applet deregistration to EVENT EVENT 
DOWNLOAD_CHANNEL STATUS 








1- An Envelope menu selection is sent to 
the UICC 


1- Appletl is triggered 






2-Appletl initializes and sends an OPEN 
CHANNEL proactive command 




2- OPEN CHANNEL 



ETSI 



Release 6 



645 



ETSI TS 102 268 V6.0.0 (2007-03) 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 




3- Applet 1 builds a CLOSE CHANNEL 
Proactive Command calling 
ProactiveHandler . initCloseChannel ( ) and 
ProactiveHandler . send ( ) methods 

4-An envelope Event Download Channel 
Status is sent to the UICC 
Channel Status = 82 00 

5- Appletl builds a Close Channel 
Proactive Command calling 
ProactiveHandler . InitCloseChannel ( ) and 
ProactiveHandler . send ( ) methods 


4- The applet is triggered 
6- Appletl finalizes 


proactive command is 
fetched 

Successful terminal 
response is sent, with 
channel ld=02 with General 
Result = 0x01 

3-CLOSE CHANNEL 
proactive command is 
fetched 

Unsuccessful TERIVIINAL 
RESPONSE of CLOSE 
CHANNEL is sent to the 
UICC with General Result = 
0X20 

5- CLOSE CHANNEL 
proactive command is 
fetched 

Successful TERMINAL 
RESPONSE of CLOSE 
CHANNEL is sent to the 
UICC with Channel Id = 02 
with General Result = 0X02 


4 


Applet triggering to 

EVENT EVENT DOWNLOAD CHANNEL 

STATUS 

1- An envelope Event Download Channel 
Status is sent to the UICC 
Channel Status = 82 00 


1 - Appletl is not triggered 




5 


Appletl not triggered after a reset 

1- Appletl is triggered by an envelope 
menu selection 

2- Appletl builds a proactive command OPEN 
CHANNEL calling ProactiveHandler . init ( ) 
method 

3- sendO method is called to register to 
this event 

4- isEventSetO method is called 

5- Reset the card 

6- An envelope Event Download Channel 
Status is sent to the UICC 

Channel Status = 82 00 


4- returns true 

6- Appletl is not triggered 


3- OPEN CHANNEL 
proactive command is 
fetched 

Successful TERMINAL 
RESPONSE of OPEN 
CHANNEL is sent to the 
UICC with Channel Id = 02 
with General Result = 0X00 
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5.5.3.21 EVENT_EVENT_DOWNLOAD_ACCESS_TECHNOLOGY_CHANGE 

Test Area Reference: Cre_Apt_Edat. 

5.5.3.21.1 Conformance requirement 

5.5.3.21.1.1 Normal execution 

• CRRN 1 : The applet is triggered by the 
EVENT_EVENT_DOWNLOAD_ACCESS_TECHNOLOGY_CHANGE once it has registered to this event 
and an Envelope Event DownLoad Access Technology Change is received. 

• CRRN2: The applet is not triggered by the 
EVENT_EVENT_DOWNLOAD_ACCESS_TECHNOLOGY_CHANGE once it has deregistered from this 
event. 



5.5.3.21.1.2 
No requirements. 

5.5.3.21.1.3 
No requirements. 



Parameter errors 



Context errors 



5.5.3.21.2 

Test Source: 
Test Applet: 
Cap File: 



Test area files 

Test_Cre_Apt_Edat.j ava. 
Cre_Apt_Edat_ 1 .j ava. 
cre_apt_edat.cap. 



5.5.3.21.3 



Test coverage 



CR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


2 



5.5.3.21.4 



Test procedure 



Id 



Description 



API/CAT RE Expectation 



APDU Expectation 



Applet registration to 

EVENT_EVENT_DOWNLOAD 

ACCESS_TECHNOLOGY_CHANGE and 

triggering 

Applet is registered to the 

EVENT_EVENT_DOWNLOAD_ACCESS_TECHNOLOGY_CHA 
NGE and to EVENT_MENU_SELECTION 

Event= 

EVENT_EVENT_DOWNLOAD_ACCESS_TECHNOLOGY_CHA 

NGE 

1- ToolkitRegistry . isEventSet method is 
called 

2- An Envelope 

EVENT_EVENT_DOWNLOAD_ACCESS_TECHNOLOGY_CHA 
NGE is sent to the UICC 



1- Method retums true 



2- Applet is triggered 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


2 


Applet deregistration 

Event= 

EVENT_EVENT_DOWNLOAD_ACCESS_TECHNOLOGY_CHA 

NGE 

ToolkitRegistry . clear Event () method is 

called 

1- An Envelope 

EVENT_EVENT_DOWNLOAD_ACCESS_TECHNOLOGY_CHA 
NGE is sent to the UICC 

2- An Envelope menu selection is sent to 
the UICC 

Event= 

EVENT_EVENT„DOWNLOAD_ACCESS_TECHNOLOGY_CHA 

NGE 

ToolkitRegistry . setEvent ( ) method is 

called 

3- An Envelope 

EVENT_EVENT_DOWNLOAD_ACCESS_TECHNOLOGY_CHA 
NGE is sent to the UICC 


1- Applet is not triggered 

2- Applet Is triggered 

3- Applet Is triggered 





5.5.3.22 EVENT_EVENT_DOWNLOAD_DISPLAY_PARAMETERS_CHANGED 

Test Area Reference: Cre_Apt_Eddp. 

5.5.3.22.1 Conformance requirement 

5.5.3.22.1.1 Normal execution 

• CRRNl: The applet is triggered by the 
EVENT_EVENT_DOWNLOAD_DISPLAY_PARAMETERS_CHANGED once it has registered to this 
event and an Envelope Event DownLoad Display Parameters Changed is received. 

• CRRN2: The applet is not triggered by the 
EVENT_EVENT_DOWNLOAD_DISPLAY_PARAMETERS_CHANGED once it has deregistered from this 
event. 



5.5.3.22.1.2 

No requirements. 

5.5.3.22.1.3 
No requirements. 

5.5.3.22.2 

Test Source: 
Test Applet: 
Cap File: 

5.5.3.22.3 



Parameter errors 
Context errors 
Test area files 

Test_Cre_Apt_Eddp.j ava. 
Cre_Apt_Eddp_l .Java. 
cre_apt_eddp . c ap . 

Test coverage 



CR Number 


Test Case Number 


CRRNl 


1,2 


CRRN2 


2 
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5.5.3.22.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Applet registration to 

EVENT EVENT DOWNLOAD 

DISPLAY_PARAMETERS_CHANGED and 

triggering 

Applet is registered to the 

EVENT_EVENT_DOWNLOAD_DISPLAY_PARAMETERS_CH 
ANGED and to EVENT_MENU_SELECTION 

Event= 

EVENT_EVENT_DOWNLOAD_DISPLAY_PARAMETERS_CH 

ANGED 

1- ToolkitRegistry . isEventSet method is 
called 

2- An Envelope 

EVENT_EVENT_DOWNLOAD_DISPLAY_PARAMETERS_CH 
ANGED is sent to the UICC 


1- Method returns true 

2- Applet is triggered 




2 


Applet deregistration 

Event= 

EVENT_EVENT_DOWNLOAD_DISPLAY_PARAMETERS_CH 

ANGED 

ToolkitRegistry . clearEvent Omethod is 

called 

1- An Envelope 

EVENT_EVENT_DOWNLOAD_DISPLAY_PARAMETERS_CH 
ANGED is sent to the UICC 

2- An Envelope menu selection is sent to 
the UICC 

Event= 

EVENT_EVENT_DOWNLOAD_DISPLAY_PARAMETERS_CH 

ANGED 

ToolkitRegistry . setEvent method is 

called 

3- An Envelope 

EVENT_EVENT_DOWNLOAD_DISPLAY_PARAMETERS_CH 
ANGED is sent to the UICC 


1- Applet is not triggered 

2- Applet is triggered 

3- Applet is triggered 





5.5.3.23 EVENT_EVENT_DOWNLOAD_LOCAL_CONNECTION 

Test Area Reference: Cre_Apt_Edlc. 



5.5.3.23.1 



Conformance requirement 



5.5.3.23.1.1 



Normal execution 



• CRRN 1 : For E VENT_E VENT_DOWNLOAD_LOC AL_CONNECTION, the framework shall only trigger 
the applet registered to this event with the associated service identifier. 

• CRRN2: The registration to the EVENT_EVENT_DOWNLOAD_LOCAL_CONNECTION is effective once 
the toolkit applet has issued a successful DECLARE SERVICE (add) proactive command, and valid till the 
first successful DECLARE SERVICE (delete) with the corresponding service identifier or the end of the card 

session. 



5.5.3.23.1.2 

No requirements. 



Parameter errors 
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5.5.3.23.1.3 
No requirements. 

5.5.3.23.2 

Test Source: 
Test Applet: 
Cap File: 

5.5.3.23.3 



Context errors 
Test area files 

Test_Cre_Apt_Edlc.j ava. 
Cre_ Apt_Edlc_ 1 .j a va . 
cre_apt_edlc . c ap . 

Test coverage 



CR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


3,4,5 



5.5.3.23.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Applet registration to 

EVENT EVENT DOWNLOAD 

LOCAL_CONNECTION 

Applet is registered to the 
EVENT_EVENT_DOWNLOAD_LOCAL_CONNECTION 
using the allocateServiceldentif ier ( ) 
method and to EVENT_MENU_SELECTION using 
the initMenuEntry method. 








1- An envelope menu selection is sent to 
the UICC 


1- Applet is triggered 






Event= 
EVENT_EVENT_DOWNLOAD_LOCAL_CONNECTION 








2- ToolkitRegistry .isEventSet method is 
called 

3- An Envelope 

EVENT_EVENT_DOWNLOAD_LOCAL_CONNECTION is 
sent to the UICC with the service 
identifier of Applet 


2- Method returns true 

3- Applet is not triggered 






4- An envelope menu selection is sent to 
the Dice 


4- Applet is triggered by the 
envelope menu selection 






5- Applet builds and sends a DECLARE 
SERVICE (add) proactive command with its 
service ID to register to this event. 


5- Applet finalizes 


5- DECLARE SERVICE 

(add) proactive command is 

fetched 

Unsuccessful TERMINAL 

RESPONSE is sent to the 

UICC with General Results 

0x20 




6- An Envelope 

EVENT_EVENT_DOWNLOAD_LOCAL_CONNECTION is 
sent to the UICC with the service 
identifier of Applet 


6- Applet is not triggered 






7- An envelope menu selection is sent to 
the UICC 


7- Applet is triggered by the 
envelope menu selection 






8- Applet builds and sends a DECLARE 
SERVICE (add) proactive command with its 
service ID to register to this event. 




8- DECLARE SERVICE 
proactive command is 
fetched 






9- Applet finalizes 


Successful TERMINAL 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 








RESPONSE is sent to the 
UICC with General Result = 
0x00 


2 


Applet triggering to 

EVENT EVENT DOWNLOAD 

LOCAL_CONNECTION 

1- An envelope Event Download local 

connection is sent to the UICC 

with the service identifier of the Applet 


1- Applet is triggered 




3 


Applet deregistration to 

EVENT EVENT DOWNLOAD 

LOCAL_CONNECTION with proactive 

command 

1- An Envelope menu selection is sent to 
the UICC 

2- Applet initializes and sends a DECLARE 
SERVICE (delete) proactive command with 
the service identifier of Applet 

3- An envelope Event Download local 
connection is sent to the UICC 

with the service identifier of the Applet 

4-Applet initializes and sends a DECLARE 
SERVICE (delete) proactive command with 
the service identifier of Applet 


1- Appletl is triggered 

Applet finalizes 

3- Applet is triggered 

5- Applet finalizes 


2- DECLARE SERVICE 

(delete) proactive command 

is fetched 

Unsuccessful TERMINAL 

RESPONSE is sent to the 

UICC with General Results 

0X20 

4- DECLARE SERVICE 

(delete) proactive command 

is fotchGcl 

Successful TERMINAL 

RESPONSE is sent to the 

UICC with General Result = 

0X00 


4 


Applet triggering to 

EVENT EVENT DOWNLOAD 

LOCAL_CONNECTION 

1- An envelope Event Download local 

connection is sent to the UICC 

with the service identifier of the Applet 


1 - Applet is not triggered 




5 


Appletl not triggered after a reset 

1- Appletl is triggered by an envelope 
menu selection 

2- Applet builds and sends a DECLARE 
SERVICE (add) proactive command with its 
service ID to register to this event 

3- An envelope Event Download local 
connection is sent to the UICC 

with the service identifier of the Applet 

4- Reset the card 

5- An envelope Event Download local 
connection is sent to the UICC 

with the service identifier of the Applet 


3- Applet is triggered 
5- Applet is not triggered 


2- DECLARE SERVICE 

(add) proactive command is 

fetched 

Successful TERMINAL 

RESPONSE is sent to the 

UICC with General Result = 

0x00 
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5.5.3.24 EVENT_APPLICATION_DESELECT 

Test Area Reference: Cre_Apt_Eade. 

5.5.3.24.1 Conformance requirement 

5.5.3.24.1.1 Normal execution 

• CRRN 1 : The applet is triggered by the EVENT_APPLIC ATION_DESELECT once it has registered to this 
event and once an application session is terminated (as described in TS 102 221 [6]). 

• CRRN2: The applet is not triggered by the EVENT_APPLICATION_DESELECT once it has deregistered 
from this event. 

• CRRN3: The AID of the deselected application is available to the Toolkit Applet in the EnvelopeHandler, as 
an AID Comprehension TLV data object as defined in the TS 102 223 [7]. 



5.5.3.24.1.2 
No requirements. 

5.5.3.24.1.3 
No requirements. 

5.5.3.24.2 

Test Source: 
Test Applet: 
Cap File: 

5.5.3.24.3 



Parameter errors 
Context errors 
Test area files 

Test_Cre_Apt_Eade.j ava. 
Cre_Apt_Eade_ 1 .j ava. 
cre_apt_eade.cap. 

Test coverage 



CR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


2 


CRRN3 


1,2 



5.5.3.24.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Applet registration to 

EVENT_APPLICATION_DESELECT and 

triggering 

Applet is registered to the 
EVENT_APPLICATION_DESELECT and to 
EVENT_MENU_SELECTION 

Event= 
EVENT_APPLICATION_DESELECT 








1- ToolkitRegistry . isEventSet method is 

called 


1- Method retums true 






2- Select for activation ADFl 


2- Applet is not triggered 






3- Select for activation ADF2 


3- Applet Is triggered 

The envelope handler contains the 

AID of ADFl 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 




4- Select for termination ADF2 


4- Applet is triggered 

The envelope handler contains the 

AIDof ADF2 




2 


Applet deregistration 

Event= EVENT_APPLICATION_DESELECT 
ToolkitRegistry . clearEvent method is 
called 

Perform UICC initialization 

1- Select for activation ADFl 








2- Select for activation ADF2 


2- Applet is not triggered 






3- Select for termination ADF2 


3- Applet is not triggered 






4- An Envelope menu selection is sent to 

the UICC 

Event= EVENT APPLICATION DESELECT 


4- Applet is triggered 






ToolkitRegistry . setEvent ( ) method is 








called 








Perform UICC initialization 








5- Select for activation ADFl 


5- Applet is not triggered 






6- Select for activation ADF2 


6- Applet is triggered 

The envelope handler contains the 

AIDof ADF1 






7- Select for termination ADF2 


7- Applet is triggered 

The envelope handler contains the 

AIDof ADF2 





5.5.3.25 EVENT_PROACTIVE_HANDLER_AVAILABLE 

Test Area Reference: Cre_Apt_Epha. 

5.5.3.25.1 Conformance requirement 

5.5.3.25.1.1 Normal execution 

• CRRN 1 : The applet is triggered by the EVENT_PROACTIVE_HANDLER_A V AILABLE once it has 
registered to this event and once the ProactiveHandler is available and all the Toolkit Applets registered to the 
previous event have been triggered and have returned from the processToolkit() invocation. 

• CRRN2: The applet is not triggered by the EVENT_PROACTIVE_HANDLER_ AVAILABLE once it has 
deregistered from this event. 

• CRRN3: When the Toolkit Applet is triggered it is automatically deregistered by the CAT Runtime 
Environment. 

• CRRN4: If a CAT session ends prior to an Applet triggering, the Applet will be triggered at the next CAT 

session. 



5.5.3.25.1.2 

No requirements. 



Parameter errors 
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5.5.3.25.1.3 
No requirements. 

5.5.3.25.2 

Test Source: 
Test Applet: 

Cap File: 
5.5.3.25.3 



Context errors 
Test area files 

Test_Cre_Apt_Epha.j ava. 
Cre_Apt_Epha_ 1 .j ava. 
Cre_Apt_Epha_2.j ava. 
cre_apt_epha .c ap . 

Test coverage 



CR Number 


Test Case Number 


CRRN1 


1 


CRRN2 


1 


CRRN3 


1 


CRRN4 


2 



5.5.3.25.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Applet registration to 

EVENT_PROACTIVE_HANDLER_AVAILABLE, 

triggering and automatic deregistration 

Appletl is registered to 
EVENT_MENU_SELECTION 
Applet2 is registered to 
EVENT_MENU_SELECTION and 
EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 








1- Appletl is triggered by an envelope 


1- Appletl is triggered 






menu selection 








1.1- ToolkitRegistry . setEvent ( ) method is 


1 .1 - No exception is thrown 






called with Event = 








EVENT_PROACTIVE_HANDLER_AVAILABLE 








1.2- ToolkitRegistry . setEvent method is 
called with Event = 


1 .2- No exception is thrown 






EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 








1.3- ToolkitRegistry . isEventSet method 








is called with Event = 


1 .3- Method returns TRUE 






EVENT_PROACTIVE_HANDLER_AVAILABLE 


1.4- 

2- Appletl is triggered by 

EVENT PROACTIVE HANDLER 








AVAILABLE 


2- SW = 9000 is returned to 




Event= EVENT_PROACTIVE_HANDLER_AVAILABLE 




the envelope 




3- ToolkitRegistry . isEventSet method is 


3- Method returns FALSE 






called by Appletl 








4- An envelope event download user 
activity is sent to the UICC 


4- Appletl is triggered by the 
envelope 






Event= EVENT_PROACTIVE_HANDLER_AVAILABLE 








5- ToolkitRegistry . setEvent method is 


5- No exception is thrown 






called by Appletl 








6- ToolkitRegistry . isEventSet {) method is 
called by Appletl 


6- Method returns TRUE 
Appletl finalizes 
Applet2 is triggered by the 






Event= 


envelope 






EVENT_PROACTIVE_HANDLER_AVAILABLE 








7- ToolkitRegistry . setEvent ( ) method is 


7- No exception Is thrown 






called by Applet2 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 




8- ToolkitRegistry .isEventSet method is 
called by Applet2 

Event= 
EVENT_PROACTIVE_HANDLER_AVAILABLE 

9- ToolkitRegistry .isEventSet method is 

called by Appletl 

Event= 
EVENT_PROACTIVE_HANDLER_AVAILABLE 

10- ToolkitRegistry .IsEventSet method is 
called by Appletl 


8- Method returns TRUE 

Applet2 finalizes 

Appletl is triggered by 

EVENT PROACTIVE HANDLER 

AVAILABLE 

9- Method returns FALSE 
Appletl finalizes 
Applet2 is triggered by 

EVENT PROACTIVE HANDLER 
AVAILABLE 

10- Method returns FALSE 
Applet2 finalizes 




2 


Applet triggering between 2 CAT sessions 

1- Appletl is triggered by an envelope 
menu selection 

1.1- Appletl prepares and sends a Display 
Text proactive command 

2- Fetch the proactive command 

3- Applet2 is triggered by an envelope 
menu selection 

3.1 Applet2 registers to 

EVENT_PROACTIVE_HANDLER_AVAILABLE then 
finalizes 

4- Reset the card and send the profile 
download command 


1- Appletl is triggered 
1.1 Appletl is suspended 

3- Applet2 is triggered 
3.1- No exception is thrown 

4- Applet2 is triggered by event 
EVENT PROACTIVE HANDLER 
AVAILABLE 





5.5.3.26 EVENT_EVENT_DOWNLOAD_NETWORK_SEARCH_MODE_CHANGE 

Test Area Reference: Cre_Apt_Edns. 

5.5.3.26.1 Conformance requirement 

5.5.3.26.1.1 Normal execution 

• CRRN 1 : The applet is triggered by the 
EVENT_EVENT_DOWNLOAD_NETWORK_SEARCH_MODE_CHANGE once it has registered to this 
event and an Envelope Event Event Download Network Search Mode Change is received. 

• CRRN2: The applet is not triggered by the 
EVENT_EVENT_DOWNLOAD_NETWORK_SEARCH_MODE_CHANGE once it has deregistered from 
this event. 



5.5.3.26.1.2 
No requirements. 

5.5.3.26.1.3 
No requirements. 



Parameter errors 



Context errors 
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5.5.3.26.2 

Test Source: 
Test Applet: 
Cap File: 

5.5.3.26.3 



Test area files 

Test_Cre_Apt_Edns.java. 
Cre_Apt_Edns_l .Java. 
cre_apt_edns.cap. 

Test coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


2 



5.5.3.26.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Applet registration to 

EVENT EVENT DOWNLOAD NETWORK SEA 

RCH_MODE_CHANGE and triggering 

Applet is registered to the 

EVENT_EVENT_DOWNLOAD_NETWORK_SEARCH_MODE_C 
HANGE and to EVENT_MENU_SELECTION 

event= 

EVENT_EVENT_DOWNLOAD_NETWORK_SEARCH_MODE_C 

HANGE 

1-ToolkitRegistry . isEventSet method is 

called 

2-An Envelope 

EVENT_EVENT_DOWNLOAD_NETWORK_SEARCH_MODE_C 
HANGE is sent to the UICC 


1- Method returns true 

2- Applet is triggered 




2 


Applet deregistration 

event= 

EVENT_EVENT_DOWNLOAD_NETWORK_SEARCH_MODE_C 

HANGE 

ToolkitRegistry . clear Event () method is 

called 

1-A network search mode change event 
dowload is sent to the UICC 

2-An Envelope menu selection is sent to 
the UICC 

Event= 

EVENT_EVENT_DOWNLOAD_NETWORK_SEARCH_MODE_C 

HANGE 

ToolkitRegistry . setEvent ( ) method is 

called 

3-An Envelope 

EVENT_EVENT_DOWNLOAD_NETWORK_SEARCH_MODE_C 
HANGE is sent to the UICC 


1- Applet is not triggered 

2- Applet is triggered 

3- Applet is triggered 
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5.5.3.27 EVENT_EVENT_DOWNLOAD_BROWSING_STATUS 

Test Area Reference: Cre_Apt_Edbs. 

5.5.3.27.1 Conformance requirement 

5.5.3.27.1.1 Normal execution 

• CRRN 1 : The applet is triggered by the E VENT_E VENT_DOWNLOAD_BROWSING_STATUS once it has 
registered to this event and an Envelope Event Event Download Browsing Status is received. 

• CRRN2: The applet is not triggered by the EVENT_EVENT_DOWNLOAD_BROWSING_STATUS once it 
has deregistered from this event. 



5.5.3.27.1.2 
No requirements. 

5.5.3.27.1.3 
No requirements. 

5.5.3.27.2 

Test Source: 
Test Applet: 
Cap File: 

5.5.3.27.3 



Parameter errors 
Context errors 
Test area files 

Test_Cre_Apt_Edbs.java. 
Cre_Apt_Edbs_l .Java. 
cre_apt_edbs.cap. 

Test coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


2 



5.5.3.27.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Applet registration to 

EVENT_EVENT_DOWNLOAD_BROWSING_STA 

JUS and triggering 

Applet is registered to the 

EVENT_EVENT_DOWNLOAD_BROWSING_STATUS and 
to EVENT_MENU_SELECTION 

event= 

EVENT_EVENT_DOWNLOAD_BROWSING_STATUS 
1-ToolkitRegistry . isEventSet method is 
called 

2-An Envelope 

EVENT_EVENT_DOWNLOAD_BROWSING_STATUS is 
sent to the UICC 


1- Method retumstrue 

2- Applet is triggered 




2 


Applet deregistration 

event= 

EVENT_EVENT_DOWNLOAD_BROWSING_STATUS 
ToolkitRegistry . clear Event () method is 
called 

1-A browsing status event dowload is sent 
to the UICC 


1 - Applet is not triggered 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 




An Envelope menu selection is sent to the 








UICC 








Event= 








EVENT_EVENT_DOWNLOAD_BROWSING_STATUS 








ToolkitRegistry . setEvent ( ) method is 








called 








2-An Envelope 


2- Applet is triggered 






EVENT_EVENT_DOWNLOAD_BROWSING_STATUS is 








sent to the UICC 







5.5.3.28 EVENT_EXTERNAL_FILE_UPDATE 

Test Area Reference: Cre_Apt_Eefu 

5.5.3.28.1 Conformance requirement 

5.5.3.28.1.1 Normal execution 

• CRRN 1 : The applet is triggered by the EVENT_EXTERN AL_FILE_UPD ATE once it has registered to this 
event and a successful execution of an UPDATE BINARY or UPDATE RECORD or INCREASE APDU 
command (sent by the Terminal and received by the UICC on the I/O line) as defined in TS 102 221 [6] is 
performed on the associated updated file. 

• CRRN2: An applet shall only be triggered once per command. 

• CRRN3: The registration to this event is effective once the applet has successfully called a method 
registerFileEvent( . . .). 

• CRRN4: The applet is not triggered by the EVENT_EXTERNAL_FILE_UPDATE once it has deregistered 
from this event. 

• CRRN5: The deregistration for a particular file to this event is effective once the Applet has successfully 
called the method deregisterFileEvent(...). 

• CRRN6: A call to the method cZeflr£'venf(EVENTjXTERNAL_FlLE_UPDATE) clears the event 
EVENT_EXTERNAL_FILE_UPDATE from the ToolkitRegistry of the Applet i.e. the Applet is no longer triggered 
when a file is updated 



5.5.3.28.1.2 
No requirements. 

5.5.3.28.1.3 



Parameter errors 



Context errors 



• CRRCl : The applet shall not be triggered if the UPDATE BINARY or UPDATE RECORD or INCREASE 
APDU command are not sent by the Terminal and received by the UICC on the I/O line. 



5.5.3.28.2 

Test Source: 
Test Applet: 
Cap File: 



Test area files 

Test_Cre_Apt_Eefu.j ava. 
Cre_Apt_Eefu_ 1 .j ava. 
cre_apt_eefu.cap. 
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5.5.3.28.3 



Test coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


1,2 


CRRN3 


1,2 


CRRN4 


2 


CRRN5 


2 


CRRN6 


3 


CRRC1 


See 3GPPTS 31.213 



5.5.3.28.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Applet registration to 

EVENT_EXTERNAL_FILE_UPDATE and 

triggering 

Applet is registered to the 
EVENT_MENU_SELECTION 

1- Send an envelope menu selection 

Event=EVENT_EXTERNAL_FILE_UPDATE 
2-ToolkitRegistry .isEventSet method is 
called 

3- ToolkitRegistry . registerFileEvent () 
method with fileview is called to register 
to EFiaHO 

4- ToolkitRegistry .isEventSet method is 
called 

5- ToolkitRegistry . registerFileEvent () 
method with paths of EFlaru and EFcaru is 
called 

6- Update EFiaRo 

7- Update EFlaru 

8- Increase EFcaru 


1 - Applet is triggered 

2- Method returns false 

3- No exception is thrown 

4- Method returns true 

5- No exception is thrown 

Applet finalizes 

6- Applet is triggered 

7- Applet is triggered 

8- Applet is triggered 




2 


Applet deregistration - case 1 

1 -Update EFiARu 

2- ToolkitRegistry . deregisterFileEvent () 
method with fileview is called to 
deregister EFcaru 

Event=EVENT_EXTERNAL_FILE_UPDATE 

3- ToolkitRegistry .isEventSet method is 
called 

4- Increase EFcaru 

5- Update EFiaru 

6- ToolkitRegistry .deregisterFileEvent () 
method with path of EFlaru is called 

7- ToolkitRegistry .isEventSet method is 
called 

8- Update EFlaru 

9- Update EFtaru 

10- ToolkitRegistry .deregisterFileEvent () 


1- Applet is triggered 

2- No exception Is thrown 

3- Method returns true 

4- Applet is not triggered 

5- Applet is triggered 

6- No exception is thrown 

7- Method returns true 

8- Applet is not triggered 

9- Applet is triggered 

10- No exception is thrown 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 




method with path of EFtaru is called 

11- ToolkitRegistry . isEventSet method is 
called 

12- Update EFtaru 


11- Method returns false 

12- Applet is not triggered 




3 


Applet deregistration - case 2 

1- Send an envelope menu selection 

2- ToolkitRegistry . registerFileEvent () 
method with fileview is called to register 
to EFtaru 

3- ToolkitRegistry . registerFileEvent () 
method with paths EFlaro and EFcaro is called 

4- Update EFtaru 

5- Update EFlaro 

6- Increase EFcaru 

Event=EVENT_EXTERNAL_FILE_UPDATE 

7- ToolkitRegistry . clearEvent method is 
called 

8- ToolkitRegistry . IsEventSet method is 
called 

9- Update EFtaro 

10- Update EFlaro 

11- Increase EFcaro 

12- Restore EFcaro, EFtaro and EFlaro 


1- Applet is triggered 

2- No exception is thrown 

3- No exception is thrown 

4- Applet is triggered 

5- Applet is triggered 

6- Applet is triggered 

7- No exception Is thrown 

8- Method returns false 

9- Applet is not triggered 

10- Applet is not triggered 
1 1 - Applet is not triggered 





5.5.4 Proactive Command Sending by tine CAT Runtime Environment 
5.5.4.1 System Proactive Commands 

Test Area Reference: Cre_Pcs_Spco. 

5.5.4.1.1 Conformance requirement 

5.5.4.1 .1 .1 Normal execution 

• CRRNl: During a CAT session the CAT Runtime Environment shall send a SET UP MENU system proactive 
command whenever a menu entry is modified, added or removed. 

• CRRN2: The CAT Runtime Environment shall use the data of the EFsume file when issuing the SET UP 
MENU proactive command. 

• CRRN3: During a CAT session the CAT Runtime Environment shall send a SET UP MENU system proactive 
command whenever the EFsume file under the DFxelecom file is updated as defined in TS 102 222 [8]. 

• CRRN4: At the beginning of a CAT session, the CAT Runtime Environment shall send a SET UP MENU 
system proactive command, if at least one menu entry is registered and enabled by a selectable Toolkit Applet. 

• CRRN5: At the beginning of a CAT session, the CAT Runtime Environment shall send a SET UP EVENT 
LIST system proactive command, if at least one event is registered by a selectable Toolkit Applet. 

• CRRN6: During a CAT session the CAT Runtime Environment shall send a SET UP EVENT LIST system 
proactive command whenever the registered event list is changed. 

• CRRN7: At the beginning of a CAT session, the CAT Runtime Environment shall send a POLL INTERVAL 
system proactive command, if at least one Toolkit Applet has requested a poll interval duration. 
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CRRN8: During a CAT session the CAT Runtime Environment shall send a POLL INTERVAL or POLLING 
OFF system proactive command whenever the system poll interval duration is changed. 

CRRN9: The CAT Runtime Environment shall send its system proactive command(s) as soon as no proactive 
session is pending and all the applets registered to the current events have been triggered and have returned 
from the processToolkit method invocation. 

CRRNIO: The system proactive command shall only contain information from Toolkit Applets that are in the 
selectable state. 

CRRNl 1 : If help is available for at least one Menu Entry inserted in the SET UP MENU system proactive 
command the CAT Runtime Environment shall indicate to the terminal that help information is available. 

CRRN12: If help is not available for all Menu Entries inserted in the SET UP MENU system proactive 
command the CAT Runtime Environment shall not indicate to the terminal that help information is available. 

CRRNl 3: If a text attribute different from the default format is provided for at least one Menu Entry, the SET 
UP MENU system proactive command shall contain the item text attribute list Comprehension TLV. The 
default format as defined in TS 123 040 [14] is '00 00 03 90'. 



5.5.4.1.1.2 

No requirements. 

5.5.4.1.1.3 

No requirements. 



Parameter errors 



Context errors 



5.5.4.1.2 

Test Source: 
Test Applet: 



Cap File: 
5.5.4.1.3 



Test area files 

Test_Cre_Pcs_Spco.java. 
Cre_Pcs_Spco_l .Java. 
Cre_Pcs_Spco_2.java. 
Cre_Pcs_Spco_3 .j ava. 
cre_pcs_spco.cap. 

Test coverage 



CRR number 


Test case number 


CRRNl 


see: 
Api_2_Tkr_Cmet, CRRNl, 
Api 2 Tkr Dmet, CRRN3, 
Api 2 Tkr Emet, CRRN3, 
Api_2_Tkr_lmet, CRRNl 
Api 2 Tkr Smta, CRRN3 


CRRN2 


1 


CRRN3 


1 


CRRN4 


2,3,4 


CRRN5 


5,6,7 


CRRN6 


8 


CRRN7 


9, 10, 11 


CRRN8 


12 


CRRN9 


13 


CRRNIO 


2,4,6,7, 10, 11 


CRRN11 


See Api 2 Tkr Cmet, CRRN6 


CRRN12 


See Api 2 Tkr Cmet, CRRN6 


CRRN13 


14 
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5.5.4.1.4 



Test procedure 



Id 



Description 



API/CAT RE Expectation 



APDU Expectation 



Set Up IVIenu at the beginning of a CAT session 

Install Applet2 

Applet2 registers to 

EVENT_UNRECOGNIZED_ENVELOPE and have its 
access conditions set to "ALWAYS" 

1- Perform UICC initialization with set up 
menu facilities supported 

2- Select EFsoke under DFielecok with a select 
by path command 

3- Update EFsoke with the text "TEST MENU" 
and Text Attribute "00 00 13 90" (Bold) 



4- An unrecognized envelope is sent to 
trigger Applet2 



5- An unrecognized envelope is sent to 
trigger Applet2 



6- The EFsuKE under DFtelecok is updated with 
the text "UICC TEST" and restore the 
initial Text Attribute 



4- Applet2 selects EFsume and 
updates its content with the text 
"TEST UICC" and no Text Attribute 

5- Applet2 selects EFsume and 
updates its content with the text 
"TEST UICC" and Text Attribute "00 
00 13 90" 



1- SET UP MENU with main 
menu "UICC TEST" 

2- SW = 9000 

3- SET UP MENU with main 
menu "TEST MENU" and 
Text Attribute "00001390" 

4- SET UP MENU with main 
menu "TEST UICC" and no 
Text Attribute 

5- SET UP MENU with main 
menu "TEST UICC" and 
Text Attribute "00001390" 



6- SET UP MENU with main 
menu "UICC TEST" 



Set Up IVIenu at the beginning of a CAT session 

1- Install Appletl 

Appletl registers to EVENT_MENU_SELECTION 

using the initMenuEntry ( ) , to 

EVENT_STATUS_COMMAND using the 

requestPollIntervall and to 

EVENT_EVENT_DOWNLOAD_MT_CALL, 

EVENT EVENT DOWNLOAD LOCATION STATUS 



1- SET UP MENU with the 
menu of Appletl 



Set Up Menu with applet in LOCK state 



1- Lock Appletl 



1- SET UP MENU With no 
menu of Appletl 



Set Up Menu with applet in SELECTABLE state 

1- Make selectable Appletl 



2- An envelope menu selection is sent to 
trigger Appletl 

3- Appletl disables its menu 

4- An envelope event download MT call is 
sent to trigger Appletl 

5- Appletl enables its menu 



2- Appletl is triggered 



4- Appletl is triggered 



1- SET UP MENU With the 
menu 



3- SET UP MENU with no 
menu 



5- SET UP MENU with the 
menu 



Set Up Event List at the beginning of a CAT 
session 

1- Perform UICC initialization with EVENT 
DOWNLOAD and set up event list facilities 
supported 



1- SET UP EVENT LIST 
proactive command 
[Event list]= '19020003' or 
'99020003' 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


6 


Setup Event List with applet in LOCK state 

1- Lock Appletl 




1- SET UP EVENT LIST 
Proactive command 
[CommandQualifier]= OOh 


7 


Setup Event List with applet in SELECTABLE 
state 

1- Make selectable Appletl 




1- SET UP EVENT LIST 
proactive command 
[Event list]= '19020003' or 
'99020003' 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


8 


Dynamic setup event list on registry 
modification 








1- An envelope menu selection is sent to 
trigger Appletl 


1- Appletl is triggered 






2- Appletl deregisters to event 
EVENT_EVENT_DOWNLOAD_MT_CALL 




2- SET UP EVENT LIST 
proactive command 
[Event list]= '190103' or 
'990103' 




3- An unrecognized envelope is sent to 
trigger Applet2 


3- Applet2 is triggered 






4- Applet registers to event 
EVENT_EVENT_DOWNLOAD_LOCAT I ON_S TATUS and 
to EVENT_EVENT_DOWNLOAD_LANGUAGE_SELECTION 

5- An envelope event download location 
status is sent to the UICC 

6- Appletl and Applet2 clear their events 
download 


5- Appletl and Applet2 are 
triggered 


4- SET UP EVENT LIST 
proactive command 
[Event list]= '19020307' or 
'99020307' 

6- SET UP EVENT LIST 
proactive command 
[CommandQualifier]= OOh 




7- An envelope menu selection is sent to 
trigger Appletl 

8- Appletl registers to event 
EVENT_EVENT_DOWNLOAD_MT_CALL 


7- Appletl is triggered 


8- SET UP EVENT LIST 
proactive command 
[Event list]= '190100' or 
'990100' 




9- Delete Appletl 




9- SET UP EVENT LIST 
proactive command 
[CommandQualifier]= OOh 




10- Install Appletl (same registration as 
before, plus registration to 
EVENT_UNRECOGNIZED_ENVELOPE) 




10- SET UP EVENT LIST 
proactive command 
[Event list]= '19020003' or 
'99020003' 


9 


Poll Interval at the beginning of a CAT session 








1- Perform UICC initialization with 
polling facilities supported 




1- POLL INTERVAL 
proactive command 


10 


Poll Interval with applet in LOCK state 

1- Lock Appletl 




1- POLLING OFF proactive 
command 


11 


Poll Interval with applet in SELECTABLE state 








1- Make selectable Appletl 




1- POLL INTERVAL 
proactive command 


12 


Dynamic Polling commands on registry 
modification 








1- A status command is sent 


1- Appletl is triggered 






2- Appletl calls the method 
requestPollInterval ( ) with 
POLL_NO_DURATION 




2- POLLING OFF proactive 
command 




3- An unrecognized envelope is sent 


3- Appletl is triggered 






4- Appletl calls the method 
requestPollInterval with 
POLL_SYSTEM_DURATION 


Appletl finalizes 
Applet2 is triggered 


4- POLL INTERVAL 
proactive command 




5- Delete Appletl 




5- POLLING OFF proactive 
command 




6- Install Appletl (same registration as 
before, plus registration to 
EVENT_UNRECOGNIZED_ENVELOPE) 




6- POLL INTERVAL 
proactive command 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


13 


System Proactive Commands sending 

1- Perform UICC initialization with system 
proactive commands facilities 

2- An unrecognized envelope is sent 

3- Appletl deregisters to event 


2- Appletl is triggered 






EVENT_EVENT_DOWNLOAD_MT_CALL and 




3- Display Text with text 




UNRECOGNIZED_ENVELOPE, disables its menu 




'textl' proactive command 




entry, calls method requestPollIntervall {) 








with POLL_NO_DURATION then builds and 


Appletl finalizes 






sends a Display Text Proactive command 








with text ' Textl ' 


Applet2 is triggered 






4- Applet2 registers to event 








EVENT_PROACTIVE_HANDLER_AVAILABLE, disable 
its menu entry then builds and sends a 
Display Text Proactive command with text 


Applet2 finalizes 


4- Display Text with text 
'text21' proactive command 




'Text21' 


Applet2 is triggered by event 
EVENT PROACTIVE HANDLER 
AVAILABLE 






5- Applet2 builds and sends a Display Text 
Proactive command with text 'Text22' 




5- Display Text with text 






Applet2 finalizes 


'text22' proactive command 

6- SET UP MENU proactive 
command with no menu, 
SET UP EVENT LIST 
proactive command 
[Event list]= '190103' or 
'9901 03' and 
POLLING OFF proactive 




7- Delete Appletl 




command 


14 


Text Attribute management in Set Up IVIenu 








1- Install Applets, Applets calls the 




1- SET UP MENU proactive 




initMenuEntry method, then reinitialize 




command with one menu 




the card. 




and no Item Text Attribute 
List or the default Text 
Attribute List '00000390" 




2- Send an Unrecognized Envelope to 


2- Applet2 is triggered 






trigger Applet2 








3- Applet2 enable its menu entry 


Applet2 finalizes 


3- SET UP MENU proactive 
command two menus and 
no Item Text Attribute List or 
the default Text Attribute 
List '0000039000000390" 




4-Send an envelope Menu Selection with the 








Item Id of Applet2 


4- Applet2 is triggered 






5- Applet2 calls 








setMenuEntryTextAttribute method to set 








the attribute to "00 00 13 90" (Bold) 


Applet2 finalizes 


5- SET UP MENU proactive 
command two menus and 
the Item Text Attribute List 
"00001390 00000390" 




6-Send an envelope Menu Selection with the 

Item Id of Applet2 


6- Applet2 is triggered 


7- SET UP MENU proactive 




7- Applet2 calls disableMenuEntry ( ) 


Applet2 finalizes 


command with one menu 
and no Item Text Attribute 
List or the default Text 
Attribute List '00000390" 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 




8-Send an envelope Menu Selection with the 

Item Id of Applets 


8- Applets is triggered 






9- Applets calls 

setMenuEntryTextAttribute ( ) method to set 
the attribute to "00 00 23 90" (Italic) 


Applets finalizes 


9- SET UP MENU proactive 
command one menu and 
the Item Text Attribute List 
■'00002S90" 




10-Send an envelope Menu Selection with 

the Item Id of Applet2 


10- Applet2 is triggered 






11- Applet2 calls enableMenuEntry () 


Applet2 finalizes 


11- SET UP MENU 
proactive command two 
menus and the Item Text 
Attribute List "00001 S90 




12-Send an envelope Menu Selection with 




00002390" 




the Item Id of Applet2 

13- Applet2 calls 

SetMenuEntryTextAttribute ( ) method to set 
the attribute to "00 00 03 90" (default) 


12- Applet2 is triggered 
Applet2 finalizes 


IS- SET UP MENU 
proactive command two 
menus and the Item Text 
Attribute List "00000S90 
00002390" 




14- Lock Applet3 




14- SET UP MENU 
proactive command with 
one menu and no Item Text 
Attribute List or the default 
Text Attribute List 
'00000S90" 




15- unlock Applet3 




15- SET UP MENU 
proactive command two 
menus and the Item Text 
Attribute List "00000S90 
00002390" 




16- Send an envelope Menu Selection with 
the Item Id of Applet3 


16- Applets is triggered 






17- Applet3 calls 
SetMenuEntryTextAttribute ( ) method to set 


Applets finalizes 


17- SET UP MENU 
proactive command two 




the attribute to "00 00 03 90" (default) 




menus and no Item Text 
Attribute List or the default 
Text Attribute List 
'00000S9000000390" 



5.5.4.2 Interaction with GSM commands 

Test Area Reference: Cre_Pcs_Igco 



5.5.4.2.1 



Conformance requirement 



5.5.4.2.1.1 



Normal execution 



CRRNl: The CAT Runtime Environment shall process a UICC command even when a proactive command is 
pending (before and after the FETCH command until the terminal response). The CAT Runtime Environment 
shall answer with the SWl and SW2 described in TS 102 221 [6] and TS 102 223 [7]. 



5.5.4.2.1.2 

No requirements. 



Parameter errors 
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5.5.4.2.1.3 

No requirements. 

5.5.4.2.2 

Test Source: 
Test Applet: 
Cap File: 

5.5.4.2.3 



Context errors 
Test area files 

Test_Cre_Pcs_Igco.j ava. 
Cre_Pcs_Igco_l .Java. 
cre_pcs_igco.cap. 

Test coverage 



CRR number 


Test case number 


CRRN1 


1,2,3 



5.5.4.2.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Interaction with GSM Commands after 

TERMINAL PROFILE in connection with FETCH 

and TERMINAL RESPONSE 

Applet is registered to Menu Selection 

RST 

TERMINAL PROFILE 

(Profile: supports all facilities except: 
SET UP EVENT LIST, POLL INTERVAL and 
POLLING OFF) 

1- System issues a proactive command 
SETUP_MENU 

2- SELECT MF 

3- Failed SELECT File 

4- FETCH 

5- SELECT MF 

6- TERMINAL RESPONSE 




1-91XX 

2- Expected data = XX XX 
XX XX 3F 00 

SW = 91XX 

3- 6A82 

4- Proactive Command: 
SETUP MENU 

5- Expected data = XX XX 
XX XX 3F 00 

SW = 9000 

6- 9000 


2 


Interaction with GSM Commands after 

ENVELOPE (MENU SELECTION) 

in connection with FETCH and TERMINAL 

RESPONSE 

Menu Entry ID = 0x01 

1- SELECT MF 

2- Failed SELECT File 

3- FETCH 

4- SELECT MF 

5- TERMINAL RESPONSE 




1 - Expected data = XX XX 
XX XX 3F 00 
SW = 91XX 

2- 6A82 

3- Proactive Command: 
Display Text 

4- Expected data = XX XX 
XX XX 3F 00 

SW = 9000 

5- 9000 


3 


Interaction with GSM Commands after 
TERMINAL RESPONSE in proactive command 
session in connection with FETCH and 
TERMINAL RESPONSE 

Menu Entry ID = 0x02 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 




1- SELECT MF 




1 - Expected data = XX XX 
XX XX 3F 00 




2- FETCH 




SW = 91XX 

2- Proactive Command: 




3- SELECT MF 




Display Text 

3- Expected data = XX XX 

XX XX 3F 00 




4- Failed SELECT File 




SW= 9000 




5- TERMINAL RESPONSE 




4- 6A82 
5- 91 XX 




6- SELECT MF 




6- Expected data = XX XX 




7-Failed SELECT File 




XX XX 3F 00 




8-FETCH 




SW = 91XX 
7-6A82 




9-SELECT MF 




8-Proactive Command: 
Display Text 




10-TERMINAL RESPONSE 




9- Expected data = XX XX 
XX XX 3F 00 
SW = 9000 
10-9000 



5.5.4.3 Proactive Command Control 

Test Area Reference: Cre_Pcs_Pcco. 



5.5.4.3.1 



Conformance requirement 



5.5.4.3.1.1 



Normal execution 



CRRNl: The CAT Runtime Environment shall prevent the toolkit applet to issue the following proactive 
commands: SET UP MENU, SET UP EVENT LIST, POLL INTERVAL, POLLING OFF. If an applet 
attempts to issue such a command, the CAT Runtime Environment shall throw an exception. 

CRRN2: The CAT Runtime Environment shall prevent a toolkit applet to issue a TIMER MANAGEMENT 
proactive command using a timer identifier, which is not allocated to it. If an applet attempts to issue such a 
command, the CAT Runtime Environment shall throw an exception. 

CRRN3: The CAT Runtime Environment shall prevent a toolkit applet to issue a SEND DATA, RECEIVE 
DATA and CLOSE CHANNEL proactive commands using a channel identifier, which is not allocated to it. If 
an applet attempts to issue such a command the CAT Runtime Environment shall throw an exception. 

CRRN4: The CAT Runtime Environment shall prevent a toolkit applet to issue an OPEN CHANNEL 
proactive command if it exceeds the maximum number of channel allocated to this applet. If an applet attempts 
to issue such a command the CAT Runtime Environment shall throw an exception. 

CRRN5: The CAT Runtime Environment shall prevent a Toolkit Applet to issue a DECLARE SERVICE (add, 
delete) proactive command using a service identifier, which is not allocated to it. If an applet attempts to send 
such a command, the CAT Runtime Environment shall throw an exception. 

CRRN6: All proactive commands shall be sent to the terminal as constructed by the Toolkit Applet without 
any check by the CAT Runtime Environment. 

CRRN7: The CAT Runtime Environment cannot guarantee that if the SET UP IDLE MODE TEXT proactive 
command is used by a Toolkit Applet, another Toolkit Applet will not overwrite this text at a later stage. 



5.5.4.3.1.2 

No requirements. 



Parameter errors 



ETSI 



Release 6 



668 



ETSI IS 102 268 V6.0.0 (2007-03) 



5.5.4.3.1.3 

No requirements. 

5.5.4.3.2 

Test Source: 
Test Applet : 



Cap File: 
5.5.4.3.3 



Context errors 
Test area files 

Test_Cre_Pcs_Pcco.j ava. 
Cre_Pcs_Pcco_l .Java. 

Cre_Pcs_Pcco_2.java. 

Cre_Pcs_Pcco_3 .j ava. 
cre_pcs_pcco.cap. 

Test coverage 



CRR number 


Test case number 


CRRN1 


1 


CRRN2 


2 


CRRN3 


3,4 


CRRN4 


3,4 


CRRN5 


5 


CRRN6 


6 


CRRN7 


Not testable 



5.5.4.3.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 





Applets installation 

Appletl is installed with 4 timers 
maximum, channel maximum, 1 menu and 4 
service identifiers maximum 
Applet2 is installed with 8 timers 
maximum, 3 channels maximum, 1 menu and 8 
service identifiers maximum 
Applets is installed with 1 channel 
maximum, 1 menu and no service identifier 






1 


STK Proactive Commands 

1- Send envelope menu selection with the 
item id of Appletl 

2- Appletl builds and sends a SET UP MENU 
proactive command 

3- Appletl builds and sends a SET UP EVENT 
LIST proactive command 

4- Appletl builds and sends a POLL 
INTERVAL proactive command 

5- Appletl builds and sends a POLLING OFF 
proactive command 


1- Appletl is triggered 

2- COMMAND_NOT_ALLOWED 
ToolkitException is thrown 

3- COMMAND_NOT_ALLOWED 
ToolkitException is thrown 

4- COMMAND_NOT_ALLOWED 
ToolkitException is thrown 

5- COMMAND_NOT_ALLOWED 
ToolkitException is thrown 


1 - 90 00 (no proactive 
command is sent) 


2 


TIMER MANAGEMENT Proactive command 

1- Send envelope menu selection with the 
item id of Applet2 

2- Applet2 allocates 8 timers by calling 
allocateTimer ( ) method and release the 3 
timers from id 1 to 3. 

3- Send envelope menu selection with the 
item id of Appletl 

4- Appletl allocates 3 timers (Id 1 to 3) 
by calling allocateTimer ( ) method 3 times 

5- Send envelope menu selection with the 
item id of Applet2 

6- Applet2 releases timers of Id 4 to 7 

7- Send envelope menu selection with the 
item id of Appletl 


1- Applet2 is triggered 

2- No exception is thrown 

3- Appletl is triggered 

4- No exception is thrown 

5- Applet2 is triggered 

6- No exception is thrown 

7- Appletl is triggered 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 




8- For each of the 3 timers allocated by 


8- No exception is thrown 


8- 3 TIMER MANAGEMENT 




Appletl (Id Ito 3) a TIMER MANAGEMENT 




proactive commands are 




proactive session is performed 




fetched 

9- The Status word of the 




9- For other timers (Id 4 to 8), Appletl 
builds and sends a TIMER MANAGEMENT 


9- COMMAND_NOT_ALLOWED 




proactive command 


ToolkitException is thrown 


last previous Terminal 
Response is 90 00 (no more 
proactive command is sent) 


3 


No Channel allowed 








1 Send envelope menu selection with the 


1- Appletl is triggered 


1 - 90 00 (no proactive 




item id of Appletl 




command is sent) 




2- Appletl builds and sends a CSD OPEN 


2- COMMAND_NOT_ALLOWED 




CHANNEL proactive command 








3- Appletl builds and sends a GPRS OPEN 


ToolkitException is thrown 






CHANNEL proactive command 


3- COMMAND_NOT_ALLOWED 






4- Appletl builds and sends a SEND DATA 


ToolkitException is thrown 






proactive command 


4- COMMAND_NOT_ALLOWED 






5- Appletl builds and sends a RECEIVE DATA 


ToolkitException is thrown 






proactive command 


5- COMMAND_NOT_ALLOWED 






6- Appletl builds and sends a CLOSE 








CHANNEL proactive command 


ToolkitException is thrown 

6- COMMAND_NOT_ALLOWED 

ToolkitException is thrown 




4 


4 Channels allowed 








1- Send envelope menu selection with the 


1- Applets is triggered 






item id of Applet3 








2- Applet3 builds and sends a CSD OPEN 
CHANNEL proactive command 


2- No exception is thrown 


2-91 1C 




3- Send a Fetch and Terminal Response OK 








on channel 7 




3- OPEN CHANNEL 
proactive 




4- Send envelope menu selection with the 








item id of Applet2 


4- Applet2 is triggered 






5- Applet2 builds and sends a CSD OPEN 








CHANNEL proactive command 








6- Send a Fetch and Terminal Response OK 


5- No exception is thrown 


5-91 10 




on channel 1 




6- OPEN CHANNEL 




7- Applet2 builds and sends a GPRS OPEN 




proactive command is 




CHANNEL proactive command 




fetched 




8- Send Fetch and Terminal Response OK on 
channel 2 


7- No exception is thrown 


7-91 17 

8- OPEN CHANNEL 




9- For each channel id from 3 to 7, 


9- COMMAND_NOT_ALLOWED 


proactive command is 




Applet2 builds and sends a SEND DATA 


ToolkitException is thrown 


fetched, SW = 91 1 Con the 




proactive command 


10- COMMAND_NOT_ALLOWED 


Terminal Response 




10- For each channel id from 3 to 7, 


ToolkitException is thrown 






Applet2 builds and sends a RECEIVE DATA 


1 1 - COMMAND_NOT_ALLOWED 






proactive command 

11- For each channel id from 3 to 7, 


ToolkitException is thrown 






Applet2 builds and sends a CLOSE CHANNEL 








proactive command 


1 2- No exception is thrown 






12- Applet2 builds and sends a CSD OPEN 








CHANNEL proactive command 




13- OPEN CHANNEL 




13- Fetch and Terminal Response OK on 




proactive command is 




channel 3 




fetched 




14- Applet2 builds and sends an OPEN 


14- COMMAND_NOT_ALLOWED 


1 4- 90 00 expected to the 




CHANNEL proactive command 


ToolkitException is thrown 


previous Terminal 
Response (no proactive 
command is sent) 


5 


DECLARE SERVICE Proactive command 








1- Send envelope menu selection with the 


1- Applet2 is triggered 






item id of Applet2 








2- Applet2 allocates 8 services by calling 








allocateServiceldentif ier ( ) method and 


2- No exception is thrown 






release the 3 services from id to 2 








using method releaseServiceldentif ier ( ) . 








3- Send envelope menu selection with the 


3- Appletl is triggered 






item id of Appletl 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 




4- Appletl allocates 3 services (Id to 
2) by calling allocateServiceldentif ier ( ) 
method 3 times 

5- Send envelope menu selection with the 
item id of Applet2 

6- Applet2 releases services of Id 5 to 7 

7- Send envelope menu selection with the 
item id of Appletl 

8- For each of the 3 services allocated by 
Appletl (Id to 2) DECLARE SERVICE (add) 
proactive commands are sent 

9- For other services (Id 3 to 8), Appletl 
builds and sends a DECLARE SERVICE (add) 
proactive command 

10- For each of the 3 services allocated 
by Appletl (Id to 2) DECLARE SERVICE 

(delete) proactive commands are sent 

11- For other services (Id 3 to 8), 
Appletl builds and sends a DECLARE SERVICE 

(delete) proactive command 


4- No exception is thrown 

5- Applet2 is triggered 

6- No exception is thrown 

7- Appletl is triggered 

8- No exception is thrown 

9- COMMAND_NOT_ALLOWED 
ToolkitException is thrown 

10- No exception is thrown 

1 1 - COMMAND_NOT_ALLOWED 
ToolkitException is thrown 


8- 3 DECLARE SERVICE 
proactive commands are 
fetched 

9- The Status word of the 
last previous Terminal 
Response is 91 1 C on the 
Terminal Response 

10- 3 DECLARE SERVICE 

proactive commands are 

fetched 

1 1 - The Status word of the 

last previous Terminal 

Response is 90 00 (no more 

proactive command is sent) 


6 


Unknown proactive command 

1- Send an envelope menu selection with 
the item id of Appletl 

2- Appletl builds an unknown proactive 
command 

3- Fetch and terminal response OK 


1- Appletl is triggered 


2- 91 08 

3- The unknown proactive 
command is fetched 



5.5.5 Exception HancJIing 
5.5.5.1 General Behaviour 

Test Area Reference: Cre_Exh_Genb. 



5.5.5.1.1 



5.5.5.1.1.1 



Conformance requirement 
Normal execution 



CRRNl: If more than one Applet shall be triggered by the currently processed event all Exceptions shall be 
caught by the CAT Runtime Environment and shall not be sent to the terminal. The CAT Runtime 
Environment shall proceed with the triggering. 

CRRN2: If only one Applet shall be triggered by the currently processed event and an ISOException with the 
reason code REPLY_BUSY is thrown, it shall be sent to the terminal using the Status Word 0x9300. 

CRRN3: If only one Applet shall be triggered by the currently processed event other Exceptions than an 
ISOException with the reason code REPLY_BUSY shall not be propagated to the terminal. 



5.5.5.1.1.2 

No requirements. 

5.5.5.1.1.3 

No requirements. 



Parameter errors 



Context errors 
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5.5.5.1.2 

Test Source: 
Test Applet: 

Cap File: 
5.5.5.1.3 



Test area files 

Test_Cre_Exh_Genb .j ava. 
Cre_Exh_Genb_l .Java. 
Cre_Exh_Genb_2 .j ava. 
cre_exh_genb.cap. 

Test coverage 



CRR Number 


Test Case Number 


CRRN1 


1 


CRRN2 


2 


CRRN3 


3 



5.5.5.1.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 





Appletl is installed and registers to 
EVENT_MENU_SELECTION and 
EVENT_EVENT_DOWNLOAD_MT_CALL 

Applet2 is installed and registers to 
EVENT_EVENT_DOWNLOAD_MT_CALL and 
EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 






1 


ISOException REPLY_BUSY is not sent to the 
terminal in multi triggering 

1- Send an envelope Event Download MT Call 
(multi triggering event, multi registered 
applets) 

4- Send an envelope Event Download MT Call 
(multi triggering event, multi registered 
applets) 


1- Appletl is triggered 

2- Appletl sends a ISOException 
with the reason code 
REPLY_BUSY then finalizes 

Applet2 is triggered, does nothing 
and finalizes 

4- Appletl is triggered, does 
nothing and finalizes 

Applet2 is triggered, sends a 
ISOException with the reason code 
REPLY_BUSY then finalizes 


3- SW = 90 00 
5- SW = 90 00 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


2 


ISOException REPLY_BUSY is sent to the 
terminal in single triggering 

1- Send an envelope Menu Selection to 
trigger Appletl (single triggering event) 

2- Send an envelope Event Download User 
Activity (multi triggering event, single 
registered applet) 


1- Appletl is triggered, sends a 
ISOException with the reason code 
REPLY_BUSY then finalizes 

2- Applet2 is triggered, sends a 
ISOException with the reason code 
REPLY BUSY then finalizes 


1 - SW = 93 00 
2- SW = 93 00 


3 


Other exception than ISOException 
REPLY_BUSY are not sent to the terminal 

1- Send an envelope Menu Selection to 
trigger Appletl (single triggering event) 

2- Send an envelope Menu Selection to 
trigger Appletl (single triggering event) 


1- Appletl is triggered, sends a 
ISOException with reason code 
different to REPLY_BUSY then 
finalizes 

2- Appletl is triggered, sends a 
ToolkitException then finalizes 


1-SW = 90 00 
2- SW = 90 00 



5.5.5.2 Interaction with Multiple Triggering 

Test Area Reference: Cre_Exh_Imtg. 



5.5.5.2.1 



5.5.5.2.1.1 



Conformance requirement 



Normal execution 



CRRNl: An exception thrown by a toolkit applet, will not influence toolkit applets registered to the same 
event. 



5.5.5.2.1.2 

No requirements. 

5.5.5.2.1.3 

No requirements. 

5.5.5.2.2 

Test Source: 
Test Applet: 

Cap File: 
5.5.5.2.3 



Parameter errors 
Context errors 
Test area files 

Test_Cre_Exh_Imtg.j ava. 
Cre_Exh_Imtg_l .Java. 

Cre_Exh_Imtg_2 .j ava. 
cre_exh_imtg.cap. 

Test coverage 



GRR Number 


Test Case Number 


CRRNl 


1,2,3,4 
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5.5.5.2.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 





Load/install 2 toolkit applets registered to 

EVENT STATUS COMMAND, 

EVENT PROFILE DOWNLOAD, 

EVENT UNRECOGNIZED ENVELOPE, 

EVENT_EVENT_DOWNLOAD_MT_CALL 

Appletl: Priority= 0x01, 
Applet2: Priority= 0x02, 
(i.e. Appletl is triggered before Applet2) 






1 


Profile_Download is sent 


1- Appletl is triggered 

2- NullPointerException is tlirown 

3- Applet2 is triggered 




2 


Status_Command is sent 


1- Appletl is triggered 

2- NullPointerException is thrown 

3- Applet2 is triggered 




3 


UNRECOGNIZED_Envelope is sent 


1- Appletl is triggered 

2- NullPointerException is thrown 

3- Applet2 is triggered 




4 


Event_Download_MT_Call is sent 


1- Appletl is triggered 

2- NullPointerException is thrown 

3- Applet2 is triggered 





5.5.6 Envelope Response Posting 
5.5.6.1 General Behaviour 

Test Area Reference: Cre_Erp_Genb. 

5.5.6.1.1 Conformance requirement 



5.5.6.1.1.1 



Normal execution 



CRRNl: A Toolkit Applet can post a response to some events with the post() or the postAsBERTLV() methods 
and can continue its processing after the call to these methods. 

CRRN2: The CAT Runtime Environment shall send the response before the emission of the next proactive 
command or when all the Toolkit Applets triggered by the event have finished their processing. 

CRRN3: The Boolean parameter passed to the post() or postAsBERTLV() method shall be mapped by the CAT 
Runtime Environment to the correct status word. If the value is true it corresponds to a successful ending of 
the command status word "9000". If the value is false it corresponds to a warning status word "6200". 



5.5.6.1.1.2 

No requirements. 



Parameter errors 
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5.5.6.1.1.3 

No requirements. 

5.5.6.1.2 
None. 

5.5.6.1.3 



Context errors 



Test area files 



Test coverage 



CRR Number 


Test Case Number 


CRRN1 


SeeApi 2 Erh Postb: CRRN1 
SeeApi 2 Erh Postbb: CRRN1 


CRRN2 


SeeApi 2 Erh Postb: CRRN3 
SeeApi 2 Erh Postbb: CRRN3 


CRRN3 


SeeApi 2 Erh Postb: CRRN4 
SeeApi 2 Erh Postbb: CRRN4 



5.5.6.1.4 
None. 



Test procedure 



5.5.6.2 EVENT_CALL_CONTROL_BY_NAA 

Test Area Reference: Cre_Erp_Eccn. 

5.5.6.2.1 Conformance requirement 

5.5.6.2.1.1 Normal execution 

• CRRNl: The CAT Runtime Environment can't reply busy when an Envelope(Call Control) is sent to the 
UICC. 



5.5.6.2.1.2 

No requirements. 

5.5.6.2.1.3 

No requirements. 

5.5.6.2.2 

Test Source: 
Test Applet: 



Cap File: 
5.5.6.2.3 



Parameter errors 
Context errors 
Test area files 

Test_Cre_Erp_Eccn.j ava. 
Cre_Erp_Eccn_l .Java. 
Cre_Erp_Eccn_2 .j ava. 
Cre_Erp_Eccn_3 .j ava. 
cre_erp_eccn.cap. 

Test coverage 



CRR Number 


Test Case Number 


CRRNl 


1,2 
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5.5.6.2.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Appletl is registered on the 

EVENT_CALL_CONTROL_BY_NAA, Applet2 is 

registered and triggered on the 

EVENT_MENU_SELECTION. 

1- Applet2 invokes the method sendO and 
no fetch is performed 

2- Envelope (Call Control) is sent to the 

UICC 

3- Appletl calls the method 
EnvelopeResponseHandler .postASBERTLV () to 
change any incoming dialling number into 
+11 22 33 44 

4- A Fetch command is sent to the UICC 

5- A Terminal Response command is sent to 
the UICC 

6- Delete Appletl S Applet2 

7- Install Applet3 


1- Applet2 is suspended 

2- Appletl is triggered 

5- Applet2's execution sliall 
continue 


S- The dialling number is 
retrieved and the status 
words is 91 XX 


2 


Applets is registered on both the events 

EVENT CALL CONTROL BY NAA and 

EVENT_MENU_SELECTION 

1- Envelope Menu Selection is sent to the 
UICC 

2- Applet3 invokes the method send () and no 
fetch is performed 

3- Envelope (Call Control) is sent to the 

UICC 

4- Applet3 calls the method 
EnvelopeResponseHandler .postASBERTLV to 
change any incoming dialling number into 
+11 22 33 44 

5- A Fetch command is sent to the UICC 

6- A Terminal Response command is sent to 
the UICC 


1- Applets is triggered on the 
EVENT_MENU_SELECTION 

2- Applets is suspended on the 
send() method 

5- Applets is triggered on the 
EVENT CALL CONTROL BY NA 
A 

6- The AppletS's execution shall 
continue 


4- The dialling number is 
retrieved and the status 
words is 91 XX 



5.5.6.3 EVENT_UNRECOGNIZED_ENVELOPE 

Test Area Reference: Cre_Erp_Euen. 

5.5.6.3.1 Conformance requirement 

5.5.6.3.1.1 Normal execution 

• CRRN 1 : The EnvelopeResponseHandler is available for the EVENT_UNRECOGNIZED_ENVELOPE. 

5.5.6.3.1 .2 Parameter errors 
No requirements. 
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5.5.6.3.1.3 

No requirements. 

5.5.6.3.2 

Test Source: 
Test Applet: 
Cap File: 

5.5.6.3.3 



5.5.6.3.4 



Context errors 
Test area files 

Test_Cre_Erp_Euen.j ava. 
Cre_Erp_Euen_ 1 .j ava. 
cre_erp_euen. cap. 

Test coverage 



CRR Number 


Test Case Number 


CRRN1 


1 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


An applet triggered on the 

EVENT_UNRECOGNIZED_ENVELOPE calls the 

EnvelopeResponseHandler.postQ method 


The post() method returns no 
exception 


The UICC answers to the 
Envelope with status words 
9000. The data retrieved are 
the ones posted by the 
applet. 



5.5.7 Toolkit Installation 
5.5.7.1 General Behaviour 

Test Area Reference: Cre Tin Genb 



5.5.7.1.1 



5.5.7.1.1.1 



Conformance requirement 
Normal execution 



CRRNl: The UICC Toolkit Application specific parameters (Tag 80h) are mandatory for applications using 
the uicc.toolkit.Toolkitlnterface defined in TS 102 241 [13]. 

CRRN2: Any additional parameters of the UICC Toolkit Application specific parameters field (Tag 80h) shall 
be ignored by the card. 

CRRN3: Some unused byte may be added at the end of the UICC Toolkit Application specific parameters field 
(Tag 80h). 

CRRN4: The UICC Access Application specific parameters (Tag Slh) are applicable to applications using the 
uicc. access. FileView defined in TS 102 241 [13]. 

CRRN5: The UICC Toolkit Application specific parameters field (Tag 80h) is not required for applications 
that do not use the uicc.toolkit.Toolkitlnterface defined in TS 102 241 [13]. 

CRRN6: The UICC Access Application specific parameters field (Tag 81h) is not required for applications 
that a do not use the uicc. access. FileView defined in TS 102 241 [13]. 



5.5.7.1.1.2 

No requirements. 



Parameter errors 
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5.5.7.1.1.3 

No requirements. 

5.5.7.1.2 

Test Source: 
Test Applet: 



Cap File: 
5.5.7.1.3 



5.5.7.1.4 



Context errors 
Test area files 

Test_Cre_Tin_Genb .j ava. 

Cre_Tin_Genb_l.java (use uicc.toolkit.Toolkitlnterface). 

Cre_Tin_Genb_2.java (use uicc. access. FileView). 

Cre_Tin_Genb_3.java (use uicc.toolkit.Toolkitlnterface and uicc. access. FileView). 

cre_tin_genb.cap. 

Test coverage 



CRR number 


Test case number 


CRRN1 


1,2 


CRRN2 


2 


CRRN3 


2 


CRRN4 


3 


CRRN5 


3 


CRRN6 


1,2 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Good installation with the only tag 80h 

1- Install (install) Appletl with only the 
UICC Toolkit Application specific 
parameters field 




1-RAPDU = 00 90 00 


2 


Good installation with the only tag 80h 

1- Install (install) Appletl with only the 
UICC Toolkit Application specific 
parameters field which contains some 
unused bytes 




1-RAPDU = 00 90 00 


3 


Good installation with the only tag 81 h 

1- Install (install) Applet2 with only the 
UICC Access Application specific 
parameters field 




1-RAPDU = 00 90 00 



5.5.7.2 Timers Allocation 

Test Area Reference: Cre_Tin_Tmal. 

5.5.7.2.1 Conformance requirement 

5.5.7.2.1.1 Normal execution 

• CRRNl: One toolkit applet can register to several timers, but a timer can only be allocated to one toolkit 
applet. 



5.5.7.2.1.2 

No requirements. 



Parameter errors 
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5.5.7.2.1.3 



Context errors 



• CRRCl: Allocated timers shall not exceed the maximum number of timers allowed for this applet instance 
defined during installation. 

• CRRC2: The total number of timers allocated for all the applets shall not exceed 8. If the maximum number of 
timers required is greater than '08' (maximum numbers of timers specified in TS 102 223 [7], the card shall 
return the Status Word '6A80', incorrect parameters in data field, to the Install(Install) command. 



5.5.7.2.2 

Test Source: 
Test Applet: 



Cap File: 
5.5.7.2.3 



Test area files 

Test_Cre_Tin_Tmal.j ava. 
Cre_Tin_Tmal_ 1 .j a va . 
Cre_Tin_Tmal_2.j ava. 
Cre_Tin_Tmal_3 .j ava. 
cre_tin_tmal. cap . 

Test coverage 



CRR number 


Test case number 


CRRN1 


2,3,8 


CRRC1 


1,7 


CRRC2 


4,5,6 



5.5.7.2.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


More than 8 timers at the instantiation of 
Appletl : check that Appletl is not installed. 

1- Install Appletl with maximum 9 timers 
allocated 

2- Appletl is selected 




1- The installation failed with 
the status word 6A80 

2- Appletl is not found, 
RAPDU != <applet selected 
data> 90 00 




Reset the card 






2 


Good installation of Applet2 

1- Install Applet2 with maximum 4 timers 
allocated 






3 


Allocate 4 timers 
Applet2 

1- An envelope menu selection is send to 
trigger Applet2 

2- Applet2 allocates 4 timers 


2- No exception shall be thrown 




4 


Allocate one more timer 
Applet2 

1- Applet2 allocates one more timer 


1- Shall throw a ToolkitException 

with reason 

NO TIMER AVAILABLE 




5 


Good installation of applets 

1- Install Applets with maximum 8 timers 
allocated 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


6 


Allocate 4 timers 
Applets 

1- an envelope menu selection is send to 
trigger Applets 

2- Applets allocates 4 timers 


2-No exception shall be thrown 




7 


Allocate one more timer 
Applets 

1- Applets allocates one more timer 


1 - Shall throw a ToolkitException 

with reason 

NO TIMER AVAILABLE 




8 


Check that each timerld (allocated by Applet2 

and applets) is between 1 and 8 and is different 

from each other 







5.5.7.3 Item Identifier 

Test Area Reference: Cre_Tin_Itid 

5.5.7.3.1 Conformance requirement 

5.5.7.3.1.1 Normal execution 

• CRRNl: If the requested item identifier in the range [1 to 127] is not already allocated, then this item identifier 
shall be allocated to the current applet. 

• CRRN2: If the requested item identifier is '00', the card shall take the first free value in the range [128,255]. 

5.5.7.3.1 .2 Parameter errors 

• CRRPl: If the requested item identifier is in the range [128,255], then the card shall reject the install 
command. 



5.5.7.3.1.3 



Context errors 



• CRRCl: If the requested item identifier in the range [1 to 127] is already allocated, then the card shall reject 
the install command. 



5.5.7.3.2 

Test Source: 
Test Applet: 



Cap File: 
5.5.7.3.3 



Test area files 

Test_Cre_Tin_ltid.j ava. 
Cre_Tin_ltid_l .j ava. 
Cre_Tin_Itid_2 .j ava. 
Cre_Tin_ltid_3 .j ava. 
cre_tin_itid.cap. 

Test coverage 



CRR number 


Test case number 


CRRN1 


2 


CRRN2 


4,5,6 


CRRP1 


1 


CRRC1 


3 
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5.5.7.3.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Bad installation of Appletl 

1- Installation of Appletl 

The following parameters item Id equal to 
128 

2- Appletl is selected 




1 - The installation failed with 
the status word 6A80 

2- Appletl is not found, 
RAPDU 1= <applet selected 
data> 90 00 


2 


Good installation of Appletl 

1- Installation of Appletl 

Item Id = 1 for the first menu and 127 for 
the second one 

2- A Terminal Profile is sent to the card 
with only PROFILE_DOWNLOAD, 
MENU_SELECTION, SET_UP_MENU and 
COMMAND_RESULT facilities. 




2- The UICC answers with 
status words 91 xx to send 
back to the ME the 2 new 
menus 

The menus are 
(position/item Id/text) 
01/01/menu11 
02/127/menu12 


3 


Bad installation of Applet2 
Item identifier already allocated 

1- Installation of Applet2 
item Id = 127 

2- Applet2 is selected 




1 - The installation failed with 
the status word 6A80 

2- Applet2 is not found, 
RAPDU != <applet selected 
data> 90 00 


4 


Good installation of Applet2 

1- Installation of Applet2 
item Id = 




1 - The UICC answers with 
status words 91 xx to send 
back to the ME the 3 menus 

The menus are 
01/01/menu11 
02/127/menu12 
03/128/menu21 


5 


Good installation of Applets 

1- Installation of Applets 
item Id = 




1 - The UICC answers with 
status words 91 xx to send 
back to the ME the 4 menus 

The menus are 

01/01/menu11 

02/127/menu12 

03/128/menu21 

04/129/menu31 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


6 


Good deletion and installation of Applet2 

1- Delete instance of Applet2 




1 - The UICC answers with 
status words 91 xx to send 
back to the ME the 3 menus 




2- Install for install of Applet2 
item Id = 




The menus are 
01/01/menu11 
02/127/menu12 
03/129/menu31 

3- The UICC answers with 
status words 91 xx to send 
bacl< to the IVIE the 4 menus 

The menus are 

01/01/menu11 

02/127/menu12 

03/128/menu21 

04/129/menu31 



5.5.7.4 Item Position 

Test Area Reference: Cre_Tin_Itpo. 

5.5.7.4.1 Conformance requirement 

5.5.7.4.1.1 Normal execution 

• CRRNl: If the new Menu Entry has to be inserted at an already occupied position, the entries from the 
requested position to the last element of the Menu Entries' list are shifted to the next positions. 

• CRRN2: If the position indicated is greater than the number of elements in the Menu Entries' list, then the 
Menu Entry takes the last position in the Menu Entries' list. 

• CRRN3: If the position indicated is equal to '00', then the Menu Entry takes the last position in the Menu 
Entries' list. 



5.5.7.4.1.2 

No requirements. 

5.5.7.4.1.3 

No requirements. 

5.5.7.4.2 

Test Source: 
Test Applet: 



Cap File: 



Parameter errors 
Context errors 
Test area files 

Test_Cre_Tin_Itpo.j ava. 
Cre_Tin_Itpo_ 1 .j ava. 
Cre_Tin_Itpo_2.j ava. 
Cre_Tin_Itpo_3 .j ava. 
Cre_Tin_Itpo_4.j ava. 
Cre_Tin_Itpo_5 .j ava. 
Cre_Tin_Itpo_6.java. 
cre_tin_itpo.cap. 
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5.5.7.4.3 



Test coverage 



CRR number 


Test case number 


CRRN1 


1 to 10 


CRRN2 


5 


CRRN3 


4 



5.5.7.4.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Installation of Appletl 

1- Install Appletl 

Position/ Itemid 

01/01 

02/02 

03/03 

04/04 




1 - The UICC answers to the 
Envelope with status words 
91 XX to send back to the ME 
the 4 menus 

The menus are 

(position'^ '/item Id/text) 

01/01/menu11 

02/02/menu12 

03/03/menu13 

04/04/menu14 

'^' position is the position in 
the set up menu proactive 
command 


2 


Installation of Applet2 

1- Install Applet2 
Position/ Itemid 
03/05 




1 - The UICC answers to the 
Envelope with status words 
91 XX to send back to the ME 
the 5 menus 

The menus are 

(position/item Id/text) 

01/01/menu11 

02/02/menu12 

03/05/menu21 

04/03/menu13 

05/04/menu14 


3 


Installation of Applets 

1- Install Applet3 

Position/ltemid 

02/06 

03/07 




1 - The UICC answers to the 
Envelope with status words 
91 XX to send back to the ME 
the 7 menus 

The menus are 

(position/item Id/text) 

01/01/menu11 

02/06/menu31 

03/07/menu32 

04/02/menu12 

06/05/menu21 

07/03/menu13 

08/04/menu14 


4 


Installation of Applet4 

1- Install Applet4 
Position/ Itemid 
00/08 




1 - The UICC answers to the 
Envelope with status words 
91 XX to send back to the ME 
the 8 menus 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 








The menus are 








(position/item Id/text) 
01/01/menu11 








02/06/menu31 








03/07/menu32 








04/02/menu12 








06/05/menu21 








07/03/menu13 








08/04/menu14 








09/08/menu41 


5 


Installation of Applets 








1- Install Applets 
Position/ Itemid 
20/09 




1 - The UICC answers to the 
Envelope with status words 
91 XX to send back to the ME 
the 9 menus 

The menus are 

(position/item Id/text) 

01/01/menu11 

02/06/menu31 

03/07/menu32 

04/02/menu12 

06/05/menu21 

07/03/menu13 

08/04/menu14 

09/08/menu41 

1 0/09/menu51 


6 


Disabling of the first menu of Appletl and 
locking of Applet2 








1- An envelope menu selection is sent with 
Item Id = 02 


1- Appletl is triggered 






2- Appletl disables its first menu (Item 
Id = 01) 




2- The UICC answers to the 
Envelope with status words 
91 XX to send back to the ME 
the 08 menus 

The menus are 

(position/item Id/text) 

01/06/menu31 

02/07/menu32 

03/02/menu12 

05/05/menu21 

06/03/menu13 

07/04/menu14 

08/08/menu41 

09/09/menu51 

3- The UICC answers to the 




3- Lock the Applet2 




Envelope with status words 
91 XX to send back to the ME 
the 07 menus 

The menus are 

(position/item Id/text) 

01/06/menu31 

02/07/menu32 

03/02/menu12 

05/03/menu13 

06/04/menu14 

07/08/menu41 

08/09/menu51 


7 


Installation of Applet6 




1 - The UICC answers to the 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 




1- Install Applete 
Position/ I temid 
01/10 
04/11 




Envelope with status words 
91 XX to send back to the ME 
the 10 menus 




15/12 




The menus are 

(position/item Id/text) 

01/10/menu61 

02/06/menu31 

03/11/menu62 

04/07/menu32 

05/02/menu12 

07/03/menu13 

08/04/menu14 

09/08/menu41 

1 0/09/menu51 

11/12/menu63 


8 


Enabling of the first menu of Appletl and 
unlocking of Applet2 








1- An envelope menu selection is sent with 
Item Id = 02 


1- Appletl is triggered 






2- Appletl enables its first menu (Item Id 
= 01) 




2- The UICC answers to the 
Envelope with status words 
91 XX to send back to the ME 
the 11 menus 

The menus are 

(position/item Id/text) 

01/10/menu61 

02/01/menu11 

03/06/menu31 

04/11/menu62 

05/07/menu32 

06/02/menu12 

08/03/menu13 

09/04/menu14 

10/08/menu41 




3- Unlock the Applet2 




11/09/menu51 
12/12/menu63 

3- The UICC answers to the 
Envelope with status words 
91 XX to send back to the ME 
the 12 menus 

The menus are 

(position/item Id/text) 

01/10/menu61 

02/01/menu11 

03/06/menu31 

04/11/menu62 

05/07/menu32 

06/02/menu12 

08/05/menu21 

09/03/menu13 

10/04/menu14 

11/08/menu41 

12/09/menu51 

13/12/menu63 


09 


Deletion of Applet2 








1- Delete Applet2 




1- The UICC answers to the 
Envelope with status words 
91 XX to send back to the ME 
the 11 menus 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 








The menus are 

(position/item Id/text) 

01/10/menu61 

02/01/menu11 

03/08/menu31 

04/11/menu62 

05/07/menu32 

06/02/menu12 

08/03/menu13 

09/04/menu14 

10/08/menu61 

11/09/menu51 

12/12/menu63 


10 


Installation of Applet2 

1- Install Applet2 

Position/Itemid 

03/05 




1 - The Dice answers to the 
Envelope with status words 
91 XX to send bacl< to the ME 
the 12 menus 

The menus are 

(position/item Id/text) 

01/10/menu61 

02/01/menu11 

03/05/menu21 

04/06/menu31 

05/11/menu62 

06/07/menu32 

07/02/menu12 

09/03/menu13 

10/04/menu14 

11/08/menu41 

12/09/menu51 

13/12/menu63 



5.5.7.5 Maximum Text Length for a menu entry 

Test Area Reference: Cre_Tin_Mlme. 

5.5.7.5.1 Conformance requirement 

5.5.7.5.1.1 Normal execution 

• CRRNl : The maximum length of item text string is defined at the installation of the toolkit applet. 

5.5.7.5.1 .2 Parameter errors 

• CRRPl : If initMenuEntry length parameter is greater than the allocated space (Maximum Text Length for a 
menu entry), then a ToolkitException ALLOWED_LENGTH_EXCEEDED is thrown. 

• CRRP2: If changeMenuEntry length parameter is greater than the allocated space (Maximum Text Length for 
a menu entry), then a ToolkitException ALLOWED_LENGTH_EXCEEDED is thrown. 



5.5.7.5.1.3 

No requirements. 



Context errors 
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5.5.7.5.2 

Test Source: 
Test Applet: 
Cap File: 

5.5.7.5.3 



Test area files 

Test_Cre_Tin_Mlme.j ava. 
Cre_Tin_Mlme_ 1 .j ava. 
cre_tin_mlme.cap. 

Test coverage 



CRR number 


Test case number 


CRRN1 


1,3,4 


CRRP1 


2 


CRRP2 


5 



5.5.7.5.4 



Test procedure 



Id 


Description 


API / Framework Expectation 


APDU Expectation 


1 


Installation of applet with 2 menus not 
exceeding the maximum text length 

Install one applet with 3 menu entries 
allowed and max. text length equal to 10. 
initMenuEntry defined at the install 
(install) command 

MenuEntry = "MenuEntryl" , "MenuEntry2" 
Offset = 
Length =10 
NextAction = '00' 
HelpSupported = false 
IconQualif ier = '00' 
Iconldentif ier = 






2 


InitMenuEntry with a too large length 

initMenuEntry with length equal to 11 

MenuEntry = " MenuEntry03" 

Offset = 

Length =11 

NextAction = '00' 

HelpSupported = false 

IconQualif ier = '00' 

Iconldentif ier = 


ToolkitException 

ALLOWED_LENGTH_EXCEEDED 
is thrown 




3 


InitMenuEntry with a right length 

InitMenuEntry with length parameter equal 

to 10 

MenuEntry = " MenuEntry 3" 

Offset = 

Length =10 

NextAction = '00' 

HelpSupported = false 

IconQualif ier = '00' 

Iconldentif ier = 




a SET UP MENU (3 items) 
is issued witli TLV item 
lengtli equal to 1 1 (Identifier 
+ Text string of item) 


4 


ChangeMenuEntry with a right length 

Appletl is triggered by a 

EVENT_MENU_SELECTION . 

ChangeMenuEntry of menu 1, with length 

parameter equal to 10 

Id = '01' 

MenuEntry = "MenuEntry4" 

Offset = 

Length = menuEntry . length 

NextAction = 

HelpSupported = false 

IconQualif ier = 

Iconldentif ier = 

Return from processToolkit 




a SET UP MENU (3 items) 
is issued witli TLV item 
length equal to 1 1 (Identifier 
+ Text string of item) 


5 


ChangeMenuEntry with a too large length 







ETSI 



Release 6 



687 



ETSI TS 102 268 V6.0.0 (2007-03) 



Id 


Description 


API / Framework Expectation 


APDU Expectation 




Appletl is triggered by a 
EVENT_MENU_SELECTION . 

ChangeMenuEntry of menu 1, with length 
parameter equal to 11 


ToolkitException 

ALLOWED_LENGTH_EXCEEDED 
is thrown 


SW = 90 00 




Id = '02' 








MenuEntry = "MenuEntryOS" 








Offset = 








Length = menuEntry . length 








NextAction = 








HelpSupported = false 








IconQualif ier = 








Iconldentif ier = 








Return from processToolkit 







5.5.7.6 Maximum number of menu entries 

Test Area Reference: Cre_Tin_Nbme. 



5.5.7.6.1 



5.5.7.6.1.1 



Conformance requirement 
Normal execution 



CRRNl: The maximum number of menu entries is defined at the installation of the toolkit applet and can be 
the maximum number of successful invocations of the method initMenuEntry. 



5.5.7.6.1.2 



Parameter errors 



• CRRPl: If the menu entry cannot be initialized (e.g. no more item data in applet loading parameter), a 
ToolkitException with the REGISTRY_ERROR reason code is thrown. 



5.5.7.6.1.3 

No requirements. 

5.5.7.6.2 

Test Source: 
Test Applet: 

Cap File: 
5.5.7.6.3 



Context errors 
Test area files 

Test_Cre_Tin_Nbme.j ava. 
Cre_Tin_Nbme_l .Java. 
Cre_Tin_Nbme_2.j ava. 
cre_tin_nb me . c ap . 

Test coverage 



CRR number 


Test case number 


CRRN1 


1 


CRRP1 


2,3 
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5.5.7.6.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Installation of applet with 3 menus 

Install (install) applet with max. number 
of menu entry is '3', defined at the 
install (install) command. 

InitMenuEntry for each menu entry allowed 
(3 times) 

MenuEntry = "menul", "menu2", "menu3" 
Offset = 
Length = 5 
NextAction = '00' 
HelpSupported = false 
IconQualif ier = '00' 
Iconldentif ier = 


No Exception is tlirown 




2 


init of a 4'*" menu 

InitMenuEntry one more time 
MenuEntry = "menu4" 
Offset = 
Length = 5 
NextAction = '00' 
HelpSupported = false 
IconQualif ier = '00' 
Iconldentif ier = 


Tooll<itException 
REGISTRY_ERROR is tlirown 


SET UP MENU (3 items: 
"menu1", "menu2", "menu3") 


3 


Installation of 2"'' applet with menu 

1- Install (install) another applet, with 
max. number of menu entry is '0', defined 
at the install (install) command. 

InitMenuEntry once 
MenuEntry = "menu5" 
Offset = 
Length = 5 
NextAction = '00' 
HelpSupported = false 
IconQualif ier = '00' 
Iconldentif ier = 

2- Perform a RESET and a Terminal Profile 
with the facilities of PROFILE_DOWNLOAD, 
MENU_SELECTION, COMMAND_RESULT and 
SET_UP_MENU 


Tooll<itException 
REGISTRY_ERROR is tlirown 


2- SET UP MENU (3 items: 
"menu1", "menu2", "menu3") 



5.5.7.7 Access Domain 

Test Area Reference: Cre_Tin_Acdo. 



5.5.7.7.1 



Conformance requirement 



5.5.7.7.1.1 



Normal execution 



CRRNl: The UICC access specific parameters (Tag 80h) indicate the mechanism used to control the 
application instance access to the File System ('00' means full access to the File System, '02' means UICC 
access mechanism and 'FF' means no access to the File System). 

CRRN2: The UICC access specific parameters are applicable to applications using the uicc. access. FileView 
defined in TS 102 241 [13]. 

CRRN3: The UICC administrative access parameter (Tag 83h) indicate the mechanism used to control the 
application instance access to the File System ('00' means full access to the File System, '02' means UICC 
access mechanism and 'FF' means no access to the File System). 

CRRN4: The UICC administrative access parameters are applicable to applications using the 
uicc.access.fileadministration.AdminFileView defined in TS 102 241 [13]. 
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CRRN5: If an application has Access Domain Parameter '00' (i.e. Full Access to the File System), all actions 
can be performed on a file except the ones with NEVER access condition. 

CRRN6: If an application has Access Domain Parameter '02' (i.e. UICC access mechanism). The UICC access 
mechanism shall be coded as follows: 



Byte 1 



b8 



b7 



b6 



b5 



b4 



b3 



b2 



b1 



Application PIN 1 
Application PIN 2 
Application PINS 
Application PIN 4 
Application PIN 5 
Application PIN 6 
Application PIN 7 
Application PIN 8 



Byte 2 



b8 b7 b6 b5 b4 b3 b2 



b1 



ADM1 
"ADM2 
"ADM3 
"ADM4 
"ADM5 
"ADM6 
"ADM7 
"ADM8 



Byte 3 



b8 



b7 



b6 



b5 



b4 



b3 



b2 



b1 



ADM9 
"ADM10 

Always 

Local PIN ( only applicable for ADF ) 
"RFU 

"rfu 
"rfu 
"rfu 



These access rights shall be checked against SE ID 01 access rules as defined in TS 102 221 [6]. 



5.5.7.7.1.2 



Parameter errors 



• CRRPl: If the Access Domain Parameter requested is not supported, the card shall return the Status Word 
'6A80', incorrect parameters in data field, to the Install(Install) command. 

• CRRP2: If an application with Access Domain Parameter 'FF' (i.e. No Access to the File System) tries to 
access a file the CAT Runtime Environement shall throw a UICCException with a 
SECURITY_STATUS_NOT_SATISFIED reason. 

• CRRP3: If an application with Access Domain Parameter '02' (i.e. UICC access mechanism) tries to access a 
file without the correct rights, the CAT Runtime Environement shall throw a UICCException with a 
SECURITY STATUS NOT SATISFIED reason. 



5.5.7.7.1.3 

No requirements. 



Context errors 
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5.5.7.7.2 

Test Source: 
Test Applet: 



Cap File: 
5.5.7.7.3 



Test area files 

Test_Cre_Tin_Acdo .j ava. 
Cre_Tin_Acdo_ 1 .j ava. 
Cre_Tin_Acdo_2.java. 
Cre_Tin_Acdo_3 .j ava. 
Cre_Tin_Acdo_4.j ava. 
Cre_Tin_Acdo_5 .j ava. 
Cre_Tin_Acdo_6 .j ava. 
Cre_Tin_Acdo_7 .j ava. 
Cre_Tin_Acdo_8 .j ava. 
cre_tin_acdo.cap. 

Test coverage 



CRR number 


Test case number 


CRRN1 


1 to 6 


CRRN2 


1 to 6 


CRRN3 


1 to 6 


CRRN4 


1 to 6 


CRRN5 


1 


CRRN6 


3 to 6 


CRRP1 


Not tested 


CRRP2 


2 


CRPP3 


3 to 6 



5.5.7.7.4 Test procedure 

The following table summarizes tests performed in the test procedure: 





Cyclic files (EFcarrx) 






Linear fixed files(EFLARRx) 








Transparent files(EFTARRx) 








Applet 
rights 


File rights 


Activate 


Deactivate 


Read 
Bin/Rec 


Update 
Bin/Rec 


Search 


Increase 


Create 


delete 


resize 


Full 
access 


Always 

(EFxARRi) 


OK 


OK 


OK 


OK 


OK 


OK 


OK 


OK 


OK 


Never 

(EFxARR2) 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


Global PIN1 
&ADM1 

(EFxARRs) 


OK 


OK 


OK 


OK 


OK 


OK 


OK 


OK 


OK 


Global PIN1 
IADM1 

(EFxARR4) 


OK 


OK 


OK 


OK 


OK 


OK 


OK 


OK 


OK 


Local PIN 1 / 
ADM2 (See 
note) 

(EFxARRs) 


OK 


OK 


OK 


OK 


OK 


OK 


OK 


OK 


OK 
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No 
Access 


Always 

(EFxARRi) 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


Never 

(EFxARR2) 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


Global PIN1 
&ADM1 

(EFxARRs) 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


Global PIN1 
IADM1 

(EFxARR4) 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


Local PIN 1 / 
ADM2 (See 
note) 

(EFxARRs) 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


Always 


Always 

(EFxARRi) 


OK 


OK 


OK 


OK 


OK 


OK 


OK 


OK 


OK 


Never 

(EFxARR2) 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


Global PIN1 
&ADM1 

(EFxARRs) 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


Global PIN1 
IADM1 

(EFxARR4) 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


Local PIN 1 / 
ADM2 (See 
note) 

(EFxARRs) 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


Global 
PIN1 


Always 

(EFxARRi) 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


Never 

(EFxARR2) 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


Global PIN1 
&ADM1 

(EFxARRs) 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


Global PIN1 
1 ADM1 

(EFxARR4) 


OK 


OK 


OK 


OK 


OK 


OK 


OK 


OK 


OK 


Local PIN 1 / 
ADM2 (See 
note) 

(EFxARRs) 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


Global 
PIN1 & 
ADM1 


Always 

(EFxARRi) 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


Never 

(EFxARR2) 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


Global PIN1 
&ADM1 

(EFxARRs) 


OK 


OK 


OK 


OK 


OK 


OK 


OK 


OK 


OK 


Global PIN1 
IADM1 

(EFxARR4) 


OK 


OK 


OK 


OK 


OK 


OK 


OK 


OK 


OK 


Local PIN 1 / 
ADM2 (See 
note) 

(EFxARRs) 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


Local 
PIN& 
ADM2 


Always 

(EFxARRi) 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


Never 

(EFxARR2) 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


Global PIN1 
&ADM1 

(EFxARRs) 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


Global PIN1 
1 ADM1 

(EFxARR4) 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 
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Local PIN 1 / 
ADM2 (See 
note) 

(EFxARRs) 


OK 


OK 


OK 


OK 


OK 


OK 


OK 


OK 


OK 



NOTE: For EFxarrs, the file access condition is Local PIN 1 if the file is located under the MF and ADM2 if it is 
located under ADFl. 



Id 



Description 



API/CAT RE Expectation 



APDU Expectation 



Full access Applet 

0- Appletl installation 
with full access right 

1- Send an envelope Menu 
Selection to trigger 
Appletl on menu Id 1 



2- Send an envelope Menu 
Selection to trigger 
Appletl on menu Id 2 



1- Appletl is triggered and gets Fileviews on UICC and 
ADF1 

1.1- For each EFcarrx Appletl calls all associated 
methods with success, except on file EFcarr2 where 
UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown. 

1 .2- For each EFlarrx Appletl calls all associated 
methods with success, except on file EFlarr2 where 
UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown. 

1 .3- For each EFtarrx Appletl calls all associated 
methods with success, except on file EFtarr2 where 
UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown. 

2- Appletl is triggered and gets AdminFileviews on 
UICC and ADFl 

2.1- For each EFcarrx Appletl calls all associated 
methods with success, except on file EFcarr2 where 
UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown. 

2.2- For each EFlarrx Appletl calls all associated 
methods with success, except on file EFlarr2 where 
UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown. 

2.3- For each EFtarrx Appletl calls all associated 
methods with success, except on file EFtarr2 where 
UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown. 

2.4- Under each DFarrx Appletl resize the EFtarxt with 
success, except on file EFtar2t where an 
UICCException.SECURITY_STATUS_NOT_SATISFIED 
is thrown. 

2.5- Under each DFarrx Appletl delete the EFtarxt with 
success, except on file EFtar2t where an 
UICCException.SECURITY_STATUS_NOT_SATISFIED 
is thrown. 

2.6- Under each DFarrx Appletl create the EFtarxt with 
success, except under DFarr2 where an 
UICCException.SECURITY_STATUS_NOT_SATISFIED 
is thrown at creation of a file similar to EFtar2t. 



1 - SW = 90 00 



2- SW = 90 00 



3- Appletl deletion 
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Id 



Description 



API/CAT RE Expectation 



APDU Expectation 



No access Applet 

0- Applet2 installation 
with no access right 

1- Send an envelope Menu 
Selection to trigger 
Applet2 on menu Id 1 



2- Send an envelope Menu 
Selection to trigger 
Applet2 on menu Id 2 



3- Applet2 deletion 



1 - Applet2 is triggered and gets Fileviews on UICC and 
ADF1 

1.1- For each EFcarrx Applet2 calls all associated 
methods; 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown. 

1 .2- For each EFlarrx Applet2 calls all associated 
methods; 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown. 

1 .3- For each EFtarrx Applet2 calls all associated 
methods; 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown. 

2- Applet2 is triggered and gets AdminFileviews on 
UICC and ADF1 

2.1- For each EFcarrx Applet2 calls all associated 
methods; 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown. 

2.2- For each EFlarrx Applet2 calls all associated 
methods; 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown. 

2.3- For each EFtarrx Applet2 calls all associated 
methods; 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown. 

2.4- Under each DFarrx Applet2 resize the EFtarxt; 
UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown. 

2.5- Under each DFarrx Applet2 delete the EFtarxt; 
UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown. 

2.6- Under each DFarrx Applet2 create an EF; 
UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown. 



1 - SW = 90 00 



2- SW = 90 00 
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Id 



Description 



API/CAT RE Expectation 



APDU Expectation 



Always access right Applet 

0- Applets installation 
with Always access right 

1- Send an envelope Menu 
Selection to trigger 
Applets on menu Id 1 



2- Send an envelope Menu 
Selection to trigger 
Applets on menu Id 2 



1 - Applets is triggered and gets Fileviews on UICC and 
ADF1 

1.1- For each EFcarrx Applets calls all associated 
methods; 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown, except on file EFcarri where the execution 

is successful. 

1 .2- For each EFlarrx Applets calls all associated 
methods; 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown, except on file EFlarri where the execution is 
successful. 

1 .S- For each EFtarrx Applets calls all associated 
methods; 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown, except on file EFtarri where the execution is 
sucessful. 

2- Applets is triggered and gets AdminFileviews on 
UICC and ADF1 

2.1- For each EFcarrx Applets calls all associated 
methods; 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown, except on file EFcarri where the execution 

is successful. 

2.2- For each EFlarrx Applets calls all associated 
methods; 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown, except on file EFlarri where the execution is 
successful. 

2.S- For each EFtarrx Applets calls all associated 
methods; 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown, except on file EFtarri where the execution is 
sucessful. 

2.4- Under each DFarrx Applets resize the EFtarxt; an 
UICCException.SECURITY_STATUS_NOT_SATISFIED 
is thrown, except on file EFtaru where the execution is 
successful. 

2.5- Under each DFarrx Applets delete the EFtarxt; an 
UICCException.SECURITY_STATUS_NOT_SATISFIED 
is thrown, except on file EFtaru where the execution is 
successful. 

2.6- Under each DFarrx Applets create an EF like the 
EFtarxt; an 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
is thrown, except on file EFtaru where the execution is 
successful. 



1 - SW = 90 00 



2- SW = 90 00 



S- Applets deletion 
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Id 



Description 



API/CAT RE Expectation 



APDU Expectation 



Global PIN1 access right 
Applet 

0- Applet4 installation 
with Global PINl access 
right 

1- Send an envelope Menu 
Selection to trigger 
Applet4 on menu Id 1 



2- Send an envelope Menu 
Selection to trigger 
Applet4 on menu Id 2 



1 - Applet4 is triggered and gets Fileviews on UICC and 
ADF1 

1.1- For eacli EFcarrx Applet4 calls all associated 
methods; 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown, except on file EFcarr4 where the execution 

is successful. 

1 .2- For each EFlarrx Applet4 calls all associated 
methods; 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown, except on file EFlarr4 where the execution is 
successful. 

1 .3- For each EFtarrx Applet4 calls all associated 
methods; 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown, except on file EFtarr4 where the execution is 
sucessful. 

2- Applet4 is triggered and gets AdminFileviews on 
UICC and ADF1 

2.1- For each EFcarrx Applet4 calls all associated 
methods; 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown, except on file EFcarr4 where the execution 

is successful. 

2.2- For each EFlarrx Applet4 calls all associated 
methods; 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown, except on file EFlarr4 where the execution is 
successful. 

2.3- For each EFtarrx Applet4 calls all associated 
methods; 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown, except on file EFtarr4 where the execution is 
sucessful. 

2.4- Under each DFarrx Applet4 resize the EFtarxt; an 
UICCException.SECURITY_STATUS_NOT_SATISFIED 
is thrown, except on file EFtar4t where the execution is 
successful. 

2.5- Under each DFarrx Applet4 delete the EFtarxt; an 
UICCException.SECURITY_STATUS_NOT_SATISFIED 
is thrown, except on file EFtar4t where the execution is 
successful. 

2.6- Under each DFarrx Applet4 create an EF like the 
EFtarxt; an 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
is thrown, except on file EFtar4t where the execution is 
successful. 



1 - SW = 90 00 



2- SW = 90 00 



3- Applet4 deletion 
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Id 



Description 



API/CAT RE Expectation 



APDU Expectation 



Global PIN1 & ADM1 access 
right Applet 

0- Applets installation 
with Global PINl & ADMl 
access right 

1- Send an envelope Menu 
Selection to trigger 
Applets on menu Id 1 



2- Send an envelope Menu 
Selection to trigger 
Applets on menu Id 2 



1- Applets is triggered and gets Fileviews on UICC and 
ADF1 

1.1- For each EFCARRx Applets calls all associated 
methods; 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown, except on files EFCARR3 and EFCARR4 
where the execution is successful. 

1 .2- For each EFLARRx Applets calls all associated 
methods; 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown, except on files EFCARR3 and EFCARR4 
where the execution is successful. 

1 .3- For each EFTARRx Applets calls all associated 
methods; 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown, except on files EFCARR3 and EFCARR4 
where the execution is sucessful. 

2- Applet3 is triggered and gets AdminFileviews on 
UICC and ADF1 

2.1- For each EFCARRx Applets calls all associated 
methods; 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown, except on files EFcarrs and EFcarr4 where 
the execution is successful. 

2.2- For each EFLARRx Applets calls all associated 
methods; 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown, except on files EFCARR3 and EFCARR4 
where the execution is successful. 

2.3- For each EFTARRx Applets calls all associated 
methods; 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown, except on files EFCARR3 and EFCARR4 
where the execution is sucessful. 

2.4- Under each DFARRx Applets resize the EFTARxT; 
an 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
is thrown, except on files EFCARR3 and EFCARR4 
where the execution is successful. 

2.5- Under each DFARRx Applets delete the EFtarxt; an 
UICCException.SECURITY_STATUS_NOT_SATISFIED 
is thrown, except on files EFcarrs and EFcarr4 where 
the execution is successful. 

2.6- Under each DFARRx Applets create an EF like the 
EFtarxt; an 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
is thrown, except on files EFcarrs and EFcarr4 where 
the execution is successful. 



1 - SW = 90 00 



2- SW = 90 00 



3- Applets deletion 
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Id 



Description 



API/CAT RE Expectation 



APDU Expectation 



Local Pin & ADM2 access right 
Applet 

0- Applet6 installation 
with Local PIN & ADM2 
access right 

1- Send an envelope Menu 
Selection to trigger 
Applet6 on menu Id 1 



2- Send an envelope Menu 
Selection to trigger 
Applet6 on menu Id 2 



1- Applets is triggered and gets Fileviews on UICC and 
ADF1 

1.1- For eacli EFcarrx Applets calls all associated 
methods; 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown, except on file EFcarrs where the execution 

is successful. 

1 .2- For each EFlarrx Applets calls all associated 
methods; 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown, except on file EFlarrs where the execution is 
successful. 

1 .3- For each EFtarrx Applets calls all associated 
methods; 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown, except on file EFtarrs where the execution is 
sucessful. 

2- Applets is triggered and gets AdminFileviews on 
UICC and ADF1 

2.1- For each EFcarrx Applets calls all associated 
methods; 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown, except on file EFcarrs where the execution 

is successful. 

2.2- For each EFlarrx Applets calls all associated 
methods; 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown, except on file EFlarrs where the execution is 
successful. 

2.3- For each EFtarrx Applets calls all associated 
methods; 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown, except on file EFtarrs where the execution is 
sucessful. 

2.4- Under each DFarrx Applets resize the EFtarxt; an 
UICCException.SECURITY_STATUS_NOT_SATISFIED 
is thrown, except on file EFtarst where the execution is 
successful. 

2.5- Under each DFarrx Applets delete the EFtarxt; an 
UICCException.SECURITY_STATUS_NOT_SATISFIED 
is thrown, except on file EFtarst where the execution is 
successful. 

2.S- Under each DFarrx Applets create an EF like the 
EFtarxt; an 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
is thrown, except on file EFtarst where the execution is 
successful. 



1 - SW = 90 00 



2- SW = 90 00 



3- Applets deletion 
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Id 



Description 



API/CAT RE Expectation 



APDU Expectation 



AdminFileview and Fileview 

acces domain parameter 

differenciation 

0- AppletV installation 
with Always & ADMl access 
right for Fileview access 
domain 

1- Send an envelope Menu 
Selection on menu id 1 to 
trigger AppletV 



2- Applet? deletion 

3- AppletV installation 
with Global PINl & ADM2 
access right for 
AdminFileview access domain 

4- Send an envelope Menu 
Selection on menu id 2 to 
trigger AppletV 



5- AppletV deletion 

6- AppletV installation 
with Always & ADMl access 
right for Fileview access 
domain and Global PINl & 
ADM2 access right for 
AdminFileview access 
domain, 

V- Send an envelope Menu 
Selection on menu id 3 to 
trigger AppletV 



8- Applet? deletion 



1- Applet? is triggered and gets Fileview on UICC. 

1.1- Using the Fileview, Applet? reads file EFtarrl No 
exception is expected 

1 .2- Using the Fileview, Applet? reads file EFtarrs- An 
UICCException.SECURITY_STATUS_NOT_SATISFIED 
is thrown 

1 .3- Using the Fileview, Applet? reads file EFtarr4- No 
exception is expected 



1 - SW = 90 00 



4- Applet? is triggered and gets AdminFileview on UICC. 

4.1- Using the AdminFileview, Applet? reads file 
EFtarrl An 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
is thrown 

4.2- Using the AdminFileview, Applet? reads file 
EFtarrs. No exception is expected 

4.3- Using the AdminFileview, Applet? reads file 
EFtarr4. No exception is expected 



4- SW = 90 00 



?- Applet? is triggered and gets Fileview and 
AdminFileview on UICC. 

?.1- Using the Fileview, Applet? reads file EFtarrl No 
exception is expected 

?.2- Using the AdminFileview, Applet? reads file 
EFtarrl An 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
Is thrown 

?.3- Using the AdminFileview, Applet? reads file 
EFtarrs- No exception is expected 

?.4- Using the Fileview, Applet? reads file EFtarrs. An 
UICCException.SECURITY_STATUS_NOT_SATISFIED 
Is thrown 

?.5- Using the Fileview, Applet? reads file EFtarr4. No 
exception is expected 

?.6- Using the AdminFileview, Applet? reads file 
EFtarr4. No exception is expected 



?- SW = 90 00 
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5.5.7.8 Priority Level 

Test Area Reference: Cre_Tin_Prlv. 



5.5.7.8.1 



5.5.7.8.1.1 



Conformance requirement 



Normal execution 



• CRRNl: The priority specifies the order of activation of an applet compared to the other applet registered to 
the same event ('01': Highest priority level, 'FF' : Lowest priority level). 

• CRRN2: If two or more applets are registered to the same event and have the same priority level, the applets 
are activated according to their installation date (i.e. the most recent applet is activated first). 



5.5.7.8.1.2 

No requirements. 

5.5.7.8.1.3 

No requirements. 

5.5.7.8.2 

Test Source: 
Test Applet: 
Cap File: 

5.5.7.8.3 



Parameter errors 
Context errors 
Test area files 

Test_Cre_Tin_Prlv_x.java, x from 1 to 12, 8A, 8B, 9A, 9B, lOA, lOB. 
Cre_Tin_Prlv_x.java, x from 1 to 12, 8A, SB, 9A, 9B, lOA, lOB. 
cre_tin_prlv_x.cap, x from 1 to 12, 8A, 8B, 9A, 9B, lOA, lOB. 

Test coverage 



CRR number 


Test case number 


CRRN1 


1,2,3,4,6,8, 10, 12 


CRRN2 


5,7,9,11 



5.5.7.8.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 





All applets are registered on an 
EVENT_EVENT_DOWNLOAD_USER_ACTIVITY event 






1 


Trigger 2 applets with 2 different maximum 
Priority Levels 

1- Install (install) Appletl with priority 
level ' 2 ' and Applet2 with priority level 

' 1 ' , from package Cre_tin_prlv_l 

2- Send an Envelope that triggers the 2 
applets with the 
EVENT_EVENT_DOWNLOAD_USER_ACTIVITY event 

3- Delete applets instances and packages 


2- A static variable is used to 
validate triggering order: Applet2 is 
triggered before Appletl 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


2 


Trigger 2 applets with 2 different maximum 
Priority Levels 

1- Install (install) Appletl with priority 
level ' 1 ' and Applet2 with priority level 

' 2 ' , from package Cre_tin_prlv_2 . 

2- Send an Envelope that triggers the 2 
applets with the 
EVENT_EVENT_DOWNLOAD_USER_ACTIVITY event . 

3- Delete applets instances and packages 


2- A static variable is used to 
validate triggering order: Appletl is 
triggered before Applet2 




3 


Trigger 2 applets with 2 different Priority 
Levels 

1- Install (install) Appletl with 
priority level '80' and Applet2 with 
priority level '7F', from package 
Cre_tin_prlv_3 . 

2- Send an Envelope that triggers the 2 
applets with the 
EVENT_EVENT_DOWNLOAD_USER_ACTIVITY event 

3- Delete applets instances and packages 


2- A static variable is used to 
validate triggering order: Applet2 is 
triggered before Appletl 




4 


Trigger 2 applets with 2 different Priority 
Levels 

1- Install (install) Appletl with 
priority level '7F' and Applet2 with 
priority level '80', from package 
Cre_tin_prlv_4 

2- Send an Envelope that triggers the 2 
applets with the 
EVENT_EVENT_DOWNLOAD_USER_ACTIVITY event 

3- Delete applets instances and packages 


2- A static variable is used to 
validate triggering order: Applet2 is 
triggered before Appletl 




5 


Trigger 3 applets with the same Priority Level 

1- Install (install) applet 1, 2, 3 in 
this order with same priority level from 
package Cre_tin_prlv_5 

2- Send an Envelope that triggers the 3 
applets with the 
EVENT_EVENT_DOWNLOAD_USER„ACTIVITY event 

3- Delete applets instances and packages 


2- A static variable is used to 
validate triggering order: Applets is 
triggered before Applet2, and 
Applet2 is triggered before Appletl 




6 


Trigger 2 applets from 2 classes, with 2 
different Priority Level 

1- Install (install) Appletl from class A 
with priority level ' 2 ' 

Install (install) Applet2 from class B 
with priority level ' 1 ' 

2- Send an Envelope that triggers the 2 
applets with the 
EVENT_EVENT_DOWNLOAD_USER_ACTIVITY event 

3- Delete applets instances and packages 


2- A static variable is used to 
validate triggering order: Applet2 is 
triggered before Appletl 




7 


Trigger 2 applets from 2 classes, with the same 
Priority Level 

1- Install (install) Appletl from class A 
with priority level ' 1 ' 

Install (install) Applet2 from class B 
with priority level ' 1 ' 

2- Send an Envelope that triggers the 2 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 




applets with the 
EVENT_EVENT_DOWNLOAD_USER_ACTIVITY event 

3- Delete applets instances and packages 


2- A static variable is used to 
validate triggering order: Applet2 is 
triggered before Appletl 




8 


Trigger 2 applets from 2 packages, with 2 
different Priority Level 

1- Install package Cre_tin_prlv_8 . 
Install (install) Appletl from package 
Cre_tin__prlv_8A with priority level ' 2 ' 
Install (install) Applet2 from package 
Cre_tin_prlv_8B with priority level ' 1 ' 

2- Send an Envelope that triggers the 2 
applets with the 
EVENT_EVENT_DOWNLOAD_USER_ACTIVITY event 

3- Delete applets instances ad packages 


2- A static variable is used to 
validate triggering order: Applet2 is 
triggered before Appletl 




9 


Trigger 2 applets from 2 packages, with the 
same Priority Level 

1- Install package Cre_tin_prlv_9 . 
Install (install) Appletl from package 
Cre_tin_prlv_9A and Applet2 from package 
Cre_tin_prlv_9B in this order, with same 
priority level 

2- Send an Envelope that triggers the 2 
applets with the 
EVENT_EVENT_DOWNLOAD_USER_ACTIVITY event 

3- Delete applets instances and packages 


2- A static variable is used to 
validate triggering order: Applet2 is 
triggered before Appletl 




10 


Trigger 4 applets from 2 packages 

1- Install packages Cre_tin_prlv_10, 
Cre_tin_prlv_10A and Cre_tin_prlv_10B 
Install (install) 2 applets 1 then 2 from 
package Cre„tin_prlv_10A, with 
respectively priority levels 1 and 2 

2- Send an Envelope that triggers the 2 
applets with the 
EVENT_EVENT_DOWNLOAD_USER_ACTIVITY event 

3- Install (install) 2 applets 3 then 4 
from package Cre_tin„prlv_10B, with 
respectively priority levels 1 and 2 

4- Send an Envelope that triggers the 4 

applets 

5- Delete applets instances and packages 


2- A static variable is used to 
validate triggering order: Appletl 
is triggered before Applet2 

4- Applets is triggered before 
applets 1, 4, then 2 




11 


Trigger 4 applets with the same Priority Level 

then delete them one after another and trigger 

them each time 

1- Install (install) applets 1, 2, 3, 4 in 
this order with same priority level from 
package Cre_tin_prlv_ll 

2- Send an Enveloppe that triggers the 4 
applets with the 
EVENT_EVENT_DOWNLOAD_USER_ACTIVITY event 

3- Delete applet instance 4 

4- Send an Enveloppe that triggers the 3 
applets with the 
EVENT_EVENT_DOWNLOAD_USER_ACTIVITY event 

5- Delete applet instance 3 

6- Send an Enveloppe that triggers the 2 


2- A static variable is used to 
validate triggering order: applets 
are triggered in order 4, 3, 2, 1 

4- Applets are triggered in order 3, 
2, 1 

6- Applets are triggered in order 2, 

1 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 




applets with the 
EVENT_EVENT_DOWNLOAD_USER_ACTIVITY event 

7- Delete remaining applet instances and 
packages 






12 


Trigger 5 applets with different Priority Levels, 
alternating install and delete 

1- Install (install) applets 1, 2, 3, 4 in 
this order with respective priority levels 
1, 2, 1, 2 

2- Send an Enveloppe that triggers the 4 
applets with the 
EVENT_EVENT_DOWNLOAD_USER_ACTIVITY event 

3- Delete applet instance 1 and install 
(install) applets with priority level 2 

4- Send an Enveloppe that triggers the 4 
applets with the 
EVENT_EVENT_DOWNLOAD_USER_ACTIVITY event 

5- Re-install (install) Appletl with 
priority level 1 

6- Send an Enveloppe that triggers the 5 
applets with the 
EVENT_EVENT_DOWNLOAD_USER__ACTIVITY event 


2- A static variable is used to 
validate triggering order: applets 
are triggered in order 3, 1 , 4, 2 

4- Applets are triggered in order 3, 
5,4,2 

6- Applets are triggered in order 1 , 
3, 5, 4, 2 





5.5.7.9 Channel Allocation 

Test Area Reference: Cre_Tin_Chal. 



5.5.7.9.1 



5.5.7.9.1.1 



Conformance requirement 
Normal execution 



CRRNl: One toolkit applet can register to several channels, but a channel can only be allocated to one toolkit 
applet. 



5.5.7.9.1.2 

No requirements. 

5.5.7.9.1.3 



Parameter errors 



Context errors 



CRRCl : Allocated channels shall not exceed the maximum number of channels allowed for this applet 
instance. 

CRRC2 : The total number of channels allocated for all the applets shall not exceed 7. If the maximum number 
of channels required is greater than '07' (maximum numbers of channels specified in ETSI TS 102 223 [7]), the 
card shall return the Status Word '6A80', incorrect parameters in data field, to the Install(Install) command. 



5.5.7.9.2 

Test Source: 
Test Applet: 



Test area files 

Test_Cre_Tin_Chal.j ava. 
Cre_Tin_Chal_ 1 .j ava. 

Cre_Tin_Chal_2.j ava. 

Cre_Tin_Chal_3 .j ava. 
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Cap File: 
5.5.7.9.3 



cre_tin_chal.cap. 



Test coverage 



CRR number 


Test case number 


CRRN1 


2,3 


CRRC1 


1,7 


CRRC2 


4,5,6 



5.5.7.9.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


More than 7 channels at the instantiation of 
Appletl : check that Appletl Is not installed 

l-Install for install of Appletl with 
maximum 8 channels allocated 

2- Select the Appletl 




2- SW = 6A 80 




Reset the card 






2 


Good installation of Applet2 

Install for install of Applet2 (maximum 4 
channels allocated) . 




The UICC answers with 
status words 90 00 


3 


Open 4 channels 
Applet2 

Applet2 builds a proactive command OPEN 
CHANNEL 4 times, calling init ( ) and send() 
methods . 


No exception shall be thrown. 


OPEN CHANNEL proactive 
command are fetched. 

Successful TERMINAL 
RESPONSE of OPEN 
CHANNEL are sent to the 
UICC with Channel Id = 01 
to 04 


4 


Open one more channel 
Applet2 

Applet2 builds a proactive command OPEN 
CHANNEL once again, calling init ( ) and 
send() methods 


Shall throw a ToolkitException with 

reason 

COMMAND NOT ALLOWED 




5 


Good installation of applets 

Install for install of Applets (maximum 7 
channels allocated) 




The UICC answers with 
status words 90 00 


6 


Open 3 channels 
Applets 

Applets builds a proactive command OPEN 
CHANNEL 3 times, calling init ( ) and sendO 
methods 


No exception shall be thrown. 


OPEN CHANNEL proactive 
command is fetched 

Successful TERMINAL 
RESPONSE of OPEN 
CHANNEL are sent to the 
UICC with Channel Id from 
05 to 07 


7 


Open one more channel 
Applet3 

Applets builds a proactive command OPEN 
CHANNEL once again, calling init ( ) and 
send() methods 


No exception shall be thrown. 


OPEN CHANNEL proactive 
command is fetched. 
Unsuccessful Terminal 
Response is sent to the 
UICC with 'No Channel 
Available' as Additional 
Information on Result 
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5.5.7.10 Minimum Security Level 

Test Area Reference: Cre_Tin_Mslv. 

5.5.7.10.1 Conformance requirement 

5.5.7.10.1.1 Normal execution 

• CRRN 1 : The Receiving Entity shall check the Minimum Security Level during processing the security of the 
Command Packet. 

• CRRN2: The Receiving Entity shall reject the message if the MSL check fails. 

• CRRN3: If the check fails, the Receiving Entity shall reject the messages and a Response Packet with the 
'Insufficient Security Level' Response Status Code shall be sent if required. 

• CRRN4: If the length of the Minimum Security Level field is greater than zero, the Minimum Security Level 
is used to specify the minimum level of security to be applied to Secured Packets. The first byte shall be the 
MSL Parameter, other bytes shall be the MSL Data. 

• CRRN5: If the length of the Minimum Security Level field is zero, no minimum security level check shall be 
performed by the receiving entity. 



5.5.7.10.1.2 


Parameter errors 


No requirements. 




5.5.7.10.1.3 


Context errors 


No requirements. 




5.5.7.10.2 


Test area files 


None. 




5.5.7.10.3 


Test coverage 



CRR number 


Test case number 


CRRN1 


Not applicable 


CRRN2 


Not applicable 


CRRN3 


Not applicable 


CRRN4 


Not applicable 


CRRN5 


Not applicable 



5.5.7.10.4 

Not applicable. 



Test procedure 



5.5.7.1 1 TAR Value(s) of the Tooil^it Application instance 

Test Area Reference: Cre Tin Tarv. 



5.5.7.11.1 



Conformance requirement 



5.5.7.1 1.1.1 Normal execution 

• CRRNl: It is possible to define several TAR Values at the installation of a Toolkit Application. 

• CRRN2: If the length of TAR Value(s) is zero, the TAR may be taken out of the AID, if any. 
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• CRRN3: If the length of the TAR Value(s) is greater than zero then the application instance shall be installed 
with the TAR Value(s) field defined above and the TAR indicated in the AID if any shall be ignored. 



5.5.7.11.1.2 
No requirements. 

5.5.7.11.1.3 



Parameter errors 



Context errors 



CRRCl If a TAR Value(s) is already assigned on the card for a Toolkit Application instance, the card shall 
return the Status Word '6A80', incorrect parameters in data field, to the INSTALL [for install] command.. 

CRRCl If the length of TAR Value(s) field is incorrect, the card shall return the Status Word '6A80', incorrect 
parameters in data field, to the INSTALL [for install] command.. 



5.5.7.11.2 

Test Source: 
Test Applet: 

Cap File: 
5.5.7.11.3 



Test area files 

Test_Cre_Tin_Tarv.j ava. 
Cre_Tin_Tarv_l .Java. 

Cre_Tin_Tarv_2 .j ava. 
cre_tin_tarv.cap. 

Test coverage 



CRR number 


Test case number 


CRRN1 


1 (but partially tested only) 


CRRN2 


Not applicable 


CRRN3 


Not applicable 


CRRC1 


1 


CRRC2 


2 



5.5.7.11.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


TAR value(s) already allocated 

1- Install Applet2 with the TAR "020202" 

2- Install Appletl with the TAR values: 
"010101" 

"020202" 
"030303" 




1-SW = RAPDU = 00 90 00 
2- SW = 6A 80 


2 


Bad TAR value(s) 

1- Install Appletl with the TAR values: 

"010101" 

"0303" 




1-SW = 6A80 
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5.5.7.12 Services Allocation 

Test Area Reference: Cre_Tin_Sval. 

5.5.7.12.1 Conformance requirement 

5.5.7.12.1.1 Normal execution 

• CRRNl: One toolkit applet can allocates several services, but a service can only be allocated to one toolkit 
applet. 



5.5.7.12.1.2 
No requirements. 

5.5.7.12.1.3 



Parameter errors 



Context errors 



CRRCl: Allocated services shall not exceed the maximum number of services allowed for this applet instance 
defined during installation. 

CRRC2: The total number of services allocated for all the applets shall not exceed 8. If the maximum number 
of services required is greater than '08' (maximum numbers of services specified in ETSI TS 102 223 [7]), the 
card shall return the Status Word '6A80', incorrect parameters in data field, to the Install(Install) command. 



5.5.7.12.2 

Test Source: 
Test Applet: 



Cap File: 
5.5.7.12.3 



Test area files 

Test_Cre_Tin_Sval.java. 
Cre_Tin_Sval_l .Java. 
Cre_Tin_Sval_2.java. 
Cre_Tin_S val_3 .j ava. 
cre_tin_sval.cap. 

Test coverage 



GRR number 


Test case number 


CRRN1 


2,3,8 


CRRC1 


1,7 


CRRC2 


4,5,6 



5.5.7.12.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


IVIore than 8 services at the instantiation of 
Appletl : check that Appletl is not installed. 

1- Install Appletl with maximum 9 services 
allocated 




1 - SW = 6A 80 




Reset the card 






2 


Good installation of Applet2 

1- Install Applet2 with maximum 4 services 
allocated 




1- RAPDU = 00 90 00 


3 


Allocate 4 services 
Applet2 


No exception shall be thrown 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


4 


Allocate one more service 
Applet2 


Shall throw a ToolkitException with 

reason 

NO_SERVICE_ID_AVAILABLE 




5 


Good installation of applets 

1- Install Applets with maximum 8 services 
allocated 




1-RAPDU = 00 90 00 


6 


Allocate 4 services 
Applets 


No exception shall be thrown 




7 


Allocate one more service 
Applets 


Shall throw a ToolkitException with 

reason 

NO_SERVICE_ID_AVAILABLE 




8 


Check that each service identifier (allocated by 

Applet2 and applets) is between and 7 and is 

different from each other 







5.5.8 UICC File Access 
5.5.8.1 FileView 

Test Area Reference: Cre_Ufa_View. 



5.5.8.1.1 Conformance requirement 

5.5.8.1 .1 .1 Normal execution 

CRRNl: Any Applet (not only Toolkit Applets) is allowed to retrieve and use a FileView. 

CRRN2: The UICC FileView can be retrieved by invoking the getTheUICCView( ) method from the 
UlCCSystem. 

CRRN3: An ADF FileView can be retrieved by invoking the getTheFileView( . . .) method with passing as 
parameter the full AID of the application owning the ADF. 

CRRN4: The UICC FileView allows to access the MP and all DFs and EFs that are located under the MP, 
including DF Telecom and any access technology specific DP located under the MF, but not the files located 
under any ADF. 

CRRN5: An ADF FileView allows to access only the DFs and EFs located under the ADF. 

CRRN6: Each FileView object shall be provided as a permanent JCRE entry point object. 

CRRN7: A separate and independent file context shall be associated with each and every FileView object: the 
operation performed on files in a given FileView object shall not affect the file context associated with any 
other FileView object. 

CRRN8: The file context can be transient or persistent depending on what was required by the Applet during 
the creation of the FileView object. 

CRRN9: Each FileView shall be given the access control privileges associated with the UICC File System or 
the corresponding ADF for the Applet. 

CRRNIO: The access control privileges are checked each time a method of the FileView object is invoked. The 
access control privileges are defined by the access domain parameters specified in ETSI TS 102 226 [10]. 

CRRN 1 1 : The root of the context of a FileView object is the MF for the UICC FileView. 

CRRN12: The root of the context of a FileView object is the ADF for an ADF FileView. 
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• CRRN13: When the transient context of a FileView is cleared, the current DF becomes the root of the 
FileView. 



5.5.8.1.1.2 

No requirements. 



Parameter errors 



5.5.8.1.1.3 Context errors 

• CRRCl : It is not possible to access the MF or any DF or EF located under the MF from an ADF FileView. 



5.5.8.1.2 

Test Source: 
Test Applet: 
Cap File: 

5.5.8.1.3 



Test area files 

Test_Cre_Ufa_View.j ava. 
Cre_Ufa_View_l .Java. 
cre_ufa_vie w. cap. 

Test coverage 



CRR number 


Test case number 


CRRN1 


1,2,3 


CRRN2 


1 , 2, 3 and see also Api 1 Cent test cases for CRRN1 


CRRN3 


1 , 2, 3 and see also Api 1 Cent test cases for CRRN1 


CRRN4 


2 and see also Api 1 Cont test cases for CRRN1 


CRRN5 


3 and see also Api 1 Cont test cases for CRRN1 


CRRN6 


4 


CRRN7 


5, 7 and see also Api 1 Cont test cases for CRRN1 


CRRN8 


6 


CRRN9 


See Cre Tin Acdo 


CRRN10 


See Cre Tin Acdo 


CRRN11 


5,6 


CRRN12 


5,6 


CRRN13 


6 


CRRCl 


3 
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5.5.8.1.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Applets can get a FileView 

1- A toolkit applet, Appletl, and a non 
toolkit applet, Applet2, are installed 
with full access to the file system 

2- An envelope menu selection is sent to 
trigger Appletl 

3- Appletl gets the UICC FileView using 
method getUICCFileView ( ) and the ADFl 
FileView getTheFileView ( ) 

4- Send an APDU to trigger Applet2 

5- Applet2 gets the UICC FileView using 
method getUICCFileView ( ) and the ADFl 
FileView getTheFileView ( ) 


2- Appletl is triggered 

3- No exception is thrown 

4- Applet2 is triggered 

5- No exception is thrown 




2 


Applets can only access all files under the MF 
using the UICC file view 

1- An envelope menu selection is sent to 
trigger Appletl 

2- Appletl gets the UICC FileView 

3- Appletl selects the MF 

4- Appletl selects the EFdir 

5- Appletl selects the DFtelecom 

6- Appletl selects the MF 

7- Appletl selects the DFtesi 

8- Appletl selects the DFtesh 

9- Appletl selects the EFtaa 

10- Appletl tries to select DFadfi 

11- Send an APDU to trigger Applet2 

12- Applet2 gets the UICC FileView 

13- Applet2 selects the MF 

14- Applet2 selects the EFdir 

15- Applet2 selects the DFtelecom 

16- Applet2 selects the MF 

17- Applet2 selects the DFtest 

18- Applet2 selects the DFtesti 

19- Applet2 selects the EFtaa 

20- Applet2 tries to select DFadfi 


1- Appletl is triggered 

3- No exception is thrown 

4- No exception is thrown 

5- No exception is thrown 

6- No exception is thrown 

7- No exception is thrown 

8- No exception is thrown 

9- No exception is thrown 

1 0- An exception is thrown 

1 1 - Applet2 is triggered 

13- No exception is thrown 

14- No exception is thrown 

15- No exception is thrown 

16- No exception is thrown 

17- No exception is thrown 

18- No exception is thrown 

19- No exception is thrown 

20- An exception is thrown 
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Applets can access all files under the ADF1 
using the ADF1 file view 

1- An envelope menu selection is sent to 
trigger Appletl 

2- Appletl gets the ADFl FileView 

3- Appletl selects the ADFl 

4- Appletl selects the DFtelecom 

5- Appletl selects the ADFl 

6- Appletl selects the DFtesi 

7- Appletl selects the DFtesti 

8- Appletl selects the EFtaa 

9- Appletl tries to select the MF 

10- Appletl tries to select the EFdir 

11- Appletl tries to select DFadf2 



to trigger Applet2 
the ADFl FileView 
cts the ADFl 

Cts the DFtelecom 

Cts the ADFl 

cts the DFtest 

cts the DFtesti 

Cts the EFtaa 

s to select the MF 

s to select the EFdir 

s to select DFadf2 



12- 


Send an 


APDU 


13- 


Applet2 


gets 


14- 


Applet2 


sele 


15- 


Applet2 


sele 


16- 


Applet2 


sele 


17- 


Applet2 


sele 


18- 


Applet2 


sele 


19- 


Applet2 


sele 


20- 


Appletl 


trie 


21- 


Appletl 


trie 


22- 


Applet2 


trie 



1- Appletl is triggered 



3- No exception is thrown 

4- No exception is thrown 

5- No exception is thrown 

6- No exception is thrown 

7- No exception is thrown 

8- No exception is thrown 

9- An exception is thrown 

1 0- An exception is thrown 
1 1 - An exception is thrown 

1 2- Applet2 is triggered 



14- No 
15- No 
16- No 
17- No 
18- No 
19- No 
20- An 
21 -An 
22- An 



exception 
exception 
exception 
exception 
exception 
exception 
exception 
exception 
exception 



is thrown 
is thrown 
is thrown 
is thrown 
is thrown 
is thrown 
is thrown 
is thrown 
is thrown 



FileView object shall be provided as a 
permanent JCRE entry point object 

1- An envelope menu selection is sent to 
trigger Appletl 

2- Appletl gets an UICC FileView in a 
static field 

3- Appletl gets an ADFl FileView in a 
static field 

4- Appletl gets an UICC FileView in a 
field of the toolkit applet 

5- Appletl gets an ADFl FileView in a 
field of the toolkit applet 

6- Send an APDU to trigger Applet2 

7- Applet2 gets an UICC FileView in a 
static field 

8- Applet2 gets an ADFl FileView in a 
static field 

9- Applet2 gets an UICC FileView in a 
field of the toolkit applet 

10- Applet2 gets an ADFl FileView in a 
field of the toolkit applet 



1- Appletl is triggered 

2- No exception is thrown 

3- No exception is thrown 

4- No exception is thrown 

5- No exception is thrown 



6- Applet2 is triggered 

7- No exception is thrown 

8- No exception is thrown 

9- No exception is thrown 



1 0- No exception is thrown 
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Context independence on FileView object 

The following sequence shall be performed 
twice, once with the UICC FlleVlew, then 
once with the ADFl FlleVlew 

1- An envelope menu selection is sent to 
trigger Appletl 

2- Appletl gets 2 UICC (or ADFl) FlleVlew 
and stores them in objects FileViewl and 
FileView2 

3- Appletl selects DFtest/EFcaru using the 
FileViewl object 

4- Appletl calls the readRecord() method 
in the NEXT mode using the FileViewl 
object 

5- Appletl calls the readRecord() method 
in the NEXT mode using the FileViewl 
object 

6- Appletl calls the readRecord() method 
in the NEXT mode using the FileView2 
object 

7- Appletl selects EFlaru using the 
FileView2 object 

8- Appletl selects DFtest using the 
FileView2 object 

9- Appletl selects EFcaru using the 
FileView2 object 

10- Appletl calls the readRecord() method 
in the NEXT mode using the FileView2 
object 

The same test sequence Is done using the 
non toolkit applet Applet2 



1- Appletl is triggered 

2- No exception is thrown 

3- No exception is thrown 

4- The record value is "55 55 55" 

5- The record value is "AA AA AA" 

6- An exception is thrown 

7- An exception is thrown 

8- No exception is thrown 

9- No exception is thrown 

1 0- The record value is "55 55 55" 



File Context can be transient or persistent 

The following sequence shall be performed 
twice, once with the UICC FlleVlew, then 
once with the ADFl FlleVlew 

1- An envelope menu selection is sent to 
trigger Appletl 

2- Appletl gets 2 UICC (or ADFl) 
FlleVlewdLnd stores one in a transient 
object FileViewl and the other in a 
persistent object FileView2 

3- Appletl selects DFtest/EFcaru using the 
FileViewl object then the FileView2 object 

4- Appletl calls the readRecord() method 
in the NEXT mode using the FileViewl 
object then the FileView2 object 

5- Reset the card 

6- An envelope menu selection is sent to 
trigger Appletl 

7- Appletl calls the status () command 
using the FileViewl 

8- Appletl calls the status () command 
using the FileView2 

9- Appletl calls the readRecord() method 
in the NEXT mode using the FileView2 

10- Appletl calls the readRecord() method 
in the NEXT mode using the FileViewl 



1- Appletl is triggered 

2- No exception is thrown 

3- No exception is thrown 

4- The record value is "55 55 55" 

6- Appletl is triggered 

7- The current DF is DFtest 

8- The current DF is the root (MF 
orADFI) 

9- The record value is "AA AA AA" 

1 0- An exception is thrown 
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File Context integrity 

1- An envelope menu selection is sent to 
trigger Appletl 

2- Appletl gets a UICC FileView and 
selects DF-Esi, with it 

3- Appletl sends a Display Text proactive 
command 

4- Send a fetch command 

5- An envelope call control by NAA is sent 

6- Appletl selects DFtesi/DFteshj using the 
previous UICC FlleVlew, then finalizes 

7- Send terminal response of Display Text 
command 

8- Appletl resumes and calls status () 
command, using the same UICC FlleVlew 



1- Appletl is triggered 

2- No exception is thrown 

3- SW = 91 XX 

4- Display Text is fetched 

5- Appletl is triggered 

6- No exception is thrown 

7- SW = 90 00 

8- The current DF is DFtesh 



5.5.8.2 File Access 

Test Area Reference: Cre_Ufa_Facc. 
Shall be covered in the API access part. 

5.5.9 Other parts transferred to framework from API 
5.5.9.1 A handler is a temporary JCRE Entry Point object 

Test Area Reference: Cre_Api_Hepo. 

5.5.9.1.1 Conformance requirement 

5.5.9.1 .1 .1 Normal execution 

• CRRNl: The EnvelopeHandler is a Temporary JCRE Entry Point Object (see Javacard 2.2.1 Runtime 
Environment (JCRE) Specification [3]). 

• CRRN2: The EnvelopeResponseHandler is a Temporary JCRE Entry Point Object (see Javacard 2.2.1 
Runtime Environment (JCRE) Specification [3]). 

• CRRN3: The ProactiveHandler is a Temporary JCRE Entry Point Object (see Javacard 2.2.1 Runtime 
Environment (JCRE) Specification [3]). 

• CRRN4: The ProactiveResponseHandler is a Temporary JCRE Entry Point Object (see Javacard 2.2.1 
Runtime Environment (JCRE) Specification [3]). 



5.5.9.1.1.2 

No requirements. 

5.5.9.1.1.3 

No requirements. 

5.5.9.1.2 

Test Source: 
Test Applet: 
Cap File: 



Parameter errors 
Context errors 
Test area files 

Test_Cre_Api_Hepo.java. 
Cre_Api_Hepo_ 1 .j ava. 
cre_api_hepo .c ap . 
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5.5.9.1.3 



Test coverage 



CRR number 


Test case number 


CRRN1 


1,2 


CRRN2 


3,4 


CRRN3 


5,6 


CRRN4 


7,8 



5.5.9.1.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


EnvelopeHandlerSystem.getTheHandlerO 

store it in a static field of the toolkit 
applet 


SecurityException is thrown 




2 


EnvelopeHandlerSystem.getTlieHandierO 

store it in a field of the toolkit applet 


SecurityException is tlirown 




3 


EnvelopeResponseHandlerSystem.getTheHan 
dIerO 

store it in a static field of the toolkit 
applet 


SecurityException is tlirown 




4 


EnvelopeResponseHandlerSystem.getTheHan 
dIerO 

store it in a field of the toolkit applet 


SecurityException is tlirown 




5 


ProactlveHandlerSystem.getTheHandlerO 

store it in a static field of the toolkit 
applet 


SecurityException is thrown 




6 


ProactiveHandlerSystem.getTheHandlerO 

store it in a field of the toolkit applet 


SecurityException is thrown 




7 


Build and send a Display Text command to 
be able to get the reference of the 
ProactiveReponseHandler 

ProactiveResponseHandlerSystem.getTheHan 
dIerO 

store it in a static field of the toolkit 
applet 


SecurityException is thrown 


Proactive command is 
fetched and terminal 
response is issued 


8 


ProactiveResponseHandlerSystem.getTheHan 
dIerO 

Store it in a field of the toolkit applet 


SecurityException is thrown 





5.5.9.2 Transaction 

Test Area Reference: Cre_Api_Tran. 

5.5.9.2.1 Conformance requirement 

5.5.9.2.1.1 Normal execution 

• CRRNl: A pending toolkit applet transaction at the ProactiveHandler.send() method invocation is aborted. 

• CRRN2: A pending toolkit applet transaction is aborted on the termination of the toolkit applet (return from 
the processToolkitO method). 

• CRRN3: At the invocation of the processToolkit() method there shall be no transaction in progress. 
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5.5.9.2.1.2 

No requirements. 

5.5.9.2.1.3 

No requirements. 

5.5.9.2.2 

Test Source: 
Test Applet: 

Cap File: 
5.5.9.2.3 



Parameter errors 
Context errors 
Test area files 

Test_Cre_Api_Tran.j ava. 
Cre_Api_Tran_ 1 .j ava. 
Cre_Api_Tran_2.j ava. 
cre_api_tran . c ap . 

Test coverage 



CRR number 


Test case number 


CRRN1 


1 


CRRN2 


2 


CRRN3 


Not testable 



5.5.9.2.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Verify that transaction is aborted when a 
proactive command is sent 

1- Appletl is triggered and performed the 
following sequence 

- Initialize a byte field with 0x05 

- Build a display text proactive command 

- beginTransaction ( ) 

- Update the byte with 0x02 

- send the proactive command 

3- Applet is resumed 

- Verify that the byte value is 0x05 

- JCSystem. getTransactionDepth ( ) 


JCSystem .getTransaction Depth () 
shall return 


2- Proactive command 
fetched and terminal 
response is issued 


2 


Verify that transaction is aborted when a 
proactive command is sent 

1- Applet2 is triggered and send a display 
text proactive command 

Appletl is triggered and performed the 
following sequence 

- Initialize a static byte field with 0x05 

- beginTransaction 

- Update the byte with 0x02 

- Finalize 

3- Applet2 is resumed and 

- Verify that the byte value is 0x05 

- JCSystem. getTransactionDepth {) 


JCSystem .getTransaction Depth () 
shall return 


2- SW = 91 XX 
Proactive command fetched 
and terminal response is 
issued 
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5.5.9.3 Timer Id between Applets 

Test Area Reference: Cre_Api_Tmid. 

5.5.9.3.1 Conformance requirement 

5.5.9.3.1.1 Normal execution 
No requirements. 

5.5.9.3.1.2 Parameter errors 
No requirements. 

5.5.9.3.1.3 Context errors 

• CRRCl; The method ToolkitRegistry.releaseTimer() shall throw a ToolkitException with 
INVALID_TIMER_ID reason if the timer is valid but is not allocated to this applet. 



5.5.9.3.2 

Test Source: 
Test Applet: 
Cap File: 

5.5.9.3.3 



Test area files 

Test_Cre_Api_Tmid.j ava. 
Cre_Api_Tmid_ 1 .j ava. 
cre_api_tmid.cap. 

Test coverage 



CRR number 


Test case number 


CRRN1 


1 



5.5.9.3.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


During installation : 

First instance allocate a timer and store 
the returned value in a static field. 
Second instance allocate a timer. 

Trigger second instance and try to call 
releaseTimer method with the static 
field value. 


releaseTimerO method call shall 
throw a ToolkitException with 
INVALID TIMER ID reason 





5.5.10 Registration 
5.5.10.1 Event registration 

Test Area Reference: Cre_Reg_Evtr. 

5.5.10.1.1 Conformance requirement 

5.5.1 0.1.1.1 Normal execution 

• CRRNl: A Toolkit Applet can change its registration to toolkit events during its whole life cycle. 

• CRRN2: The registration of a Toolkit Applet to an event shall not be affected by its life cycle state. 

• CRRN3: The getShareableInterfaceObject() has to be called before the applet is triggered the first time. 
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• CRRN4: The byte parameter of getShareableInterfaceObject() method has to be set to '01'. 

• CRRN5: The AID parameter of the getShareableInterfaceObject() method shall be set to null. 



5.5.10.1.1.2 
No requirements. 

5.5.10.1.1.3 
No requirements. 

5.5.10.1.2 

Test Source: 
Test Applet: 

Cap File: 
5.5.10.1.3 



Parameter errors 
Context errors 
Test area files 

Test_Cre_Reg_Evtr.j ava. 
Cre_Reg_Evtr_ 1 .j ava. 
Cre_Reg_Evtr_2 .j ava. 
cre_reg_e vtr . c ap . 

Test coverage 



CRR number 


Test case number 


CRRN1 


1 but partially tested 


CRRN2 


1, 

and see also 

CRRN9 of Cre_Pcs_Spco 

and 
CRRN3 of Cre Apt Eccn 


CRRN3 


2 


CRRN4 


2 


CRRN5 


2 



5.5.10.1.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Toolkit applet can change its registration 
during its whole life cycle 

1- Install Appletl to let it in the 
INSTALL state 

During its install () method, Appletl 
registers to 
EVENT_EVENT_DOWNLOAD_USER_ACTIVITY and 








EVENT_EVENT_DOWNLOAD_MT_CALL 

2- Make selectable Appletl 

3- An envelope Event Download User 
Activity is sent to trigger Appletl 


3- Appletl is triggered 


2- Set Up Event List 
proactive command is 
fetched with User Activity 
and MT Call events 




4- Appletl registers to 

EVENT_EVENT_DOWNLOAD_LOCAT I ON_S TATUS and 
deregisters to 




4- Set Up Event List 
proactive command is 
fetched with Location Status 




EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 




and UJ Call events 
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getShareablelnterfaceObJectQ has to be called 
before the first triggering 

1- Install of Applet2 

Applet2 getShareablelnterfaceObject () 
method increments a counter 

2- Trigger Applet2 



2- Applet2 performs the following 
checks: 

- the counter is incremented 

- byte parameter of 
getShareablelnterfaceObJectQ 
method is set to '01' 

- AID parameter 
getShareablelnterfaceObJectQ 
method is null 



5.5.11 UICC Toolkit Applet 
5.5.1 1 .1 Data and function sharing 

Test Area Reference: Cre_Uta_Dafs. 



5.5.11.1.1 



Conformance requirement 



The sharing mechanism defined in "Java CardT"^ 2.2.1 AppUcation Programming Interface Specification" ([2]) and 
"Java CardT"^ 2.2.1 Runtime Environment Specification" ([3]) shall be used by the Toolkit Applet(s) to share data and 
function. 

5.5.11.1.1.1 Normal execution 

• CRRNl:The interface shall extend the javacard.framework.shareable interface. 

• CRRN2: The server Applet shall overwrite the Applet.getShareableInterfaceObject() method. 

• CRRN3: The client Applet shall use the JCSystem.getAppletShareablelnterfaceObject() to retrieve a reference 
to the server Applet shareable interface. 

• CRRN4: When the client Applet calls JCSystem.getAppletShareableInterfaceObject() method the 
Applet.getShareablelnterfaceObjectO method of the server Applet is called by the CAT RE. 



Parameter errors 



5.5.11.1.1.2 
No requirements. 

5.5.11.1.1.3 Context errors 

No requirements. 

5.5.11.1.2 Test area files 

This clause uses 2 packages: 

uicc.test.catre.cre_uta_dafs.cre_uta_dafs_a 

uicc.test.catre.cre_uta_dafs.cre_uta_dafs_b 

Test Source: Test_Cre_Uta_Dafs.java. 

Test Applet: Cre_Uta_Dafs_A_l.java (server applet). 

Cre_Uta_Dafs_A_2.java (server interface). 
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Cap File: 



Cre_Uta_Dafs_A_3.java (class). 
Cre_Uta_Dafs_B_l.java (client applet). 
cre_uta_daf s_a . c ap . 
cre_ut a_daf s_b . cap . 



5.5.11.1.3 



Test coverage 



CRR number 


Test case number 


CRRN1 


1 


CRRN2 


1 


CRRN3 


1 


CRRN4 


1 



5.5.11.1.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 





1- Install packages PackageA then Packages 

2- Install AppletAl and AppletBl 






1 


Use of a shareable interface 

1- Send an envelope Menu Selection to 
trigger AppletAl (Menu Id = 01) 

2- AppletAl stores the menu Id 

3- Send an envelope Menu Selection to 
trigger AppletBl 

4- AppletBl uses the shareable interface 
of AppletAl to retrieve the Menu Id that 
was used to trigger AppletAl previously 


1 - AppletAl is triggered 

3- AppletBl is triggered 

4- l\/lenu Id retrieved shall be 01 





5.5.11.2 Package deletion 

Test Area Reference: Cre Uta Pdel. 



5.5.11.2.1 



Conformance requirement 



The Package deletion mechanism defined in "Java Caid^^ 2.2.1 Runtime Environment Specification" ([3]) shall be used 
to delete the content from the UICC. 



5.5.11.2.1.1 



Normal execution 



CRRNl: If the applet/library package is resident in mutable memory, then the Java Card RE shall delete the 
applet/library package. 

CRRN2: Following a successful applet/library package deletion, it shall not be possible to install another 
package which depends on the deleted package. 



5.5.11.2.1.2 
No requirements. 

5.5.11.2.1.3 



Parameter errors 



Context errors 



• CRRCl: The deletion shall fail if a reachable (non-garbage) instance of a class belonging to the package being 
deleted exists on the card. 
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• CRRC2: The deletion shall fail if another package on the card depends on this package (as expressed in the 
CAP file's import component). 

5.5.11.2.2 Test area files 

This clause uses 2 packages: 

uicc.test.catre.cre_uta_pdel.cre_uta_pdel_a 

uicc.test.catre.cre_uta_pdel.cre_uta_pdel_b (depends on uicc.test.catre.cre_uta_pdel.cre_uta_pdel_a) 

Test Source: Test_Cre_Uta_Pdel.java. 

Test Applet: Cre_Uta_Pdel_A_l.java. 

Cre_Uta_Pdel_A_2.j ava. 

Cre_Uta_Pdel_A_3.java (server interface) Cre_Uta_Pdel_B_l.java (use class Cre_Uta_Pdel_A_2). 

Cre_Uta_Pdel_B_2.j ava. 
Cap File: cre_uta_pdel_a.cap. 

cre_uta_pdel_b . cap . 



5.5.11.2.3 



Test coverage 



CRR number 


Test case number 


CRRN1 


1 to 5 


CRRN2 


3 


CRRC1 


1 


CRRC2 


2 
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5.5.11.2.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 





1- Install packages PackageA then PackageB 

2- Install AppletBl 






1 


The package deletion is unsuccessful if a 

reachable instance of a class belonging to the 

package exists on the card 

1- Delete PackageB 

2- Install AppletB2 

3- Delete AppletBl and AppletB2 




1-SW shall be different 

from 90 00 

2- RAPDU = 00 90 00 


2 


The package deletion is unsuccessful if 

another package on the card depends on this 

package 

1- Delete PackageA 

2- Install AppletAl 

3- Delete AppletAl 




1 - SW shall be different 

from 90 

02- RAPDU = 00 90 00 


3 


The installation of a package which depends 
on a deleted package shall fail 

1- Delete PackageB 

2- Delete PackageA 

3- Install PackageB 




1 - SW = 90 00 

2- SW = 90 00 

3- SW shall be different 
from 90 00 


4 


Once a package is deleted, it shall not be 
possible to install an applet from this package 

1- Install AppletAl 

2- Install AppletB2 




1 - SW = SW shall be 
different from 90 00 

2- SW = SW shall be 
different from 90 00 


5 


This test checks that it is possible to re-install 
the same package 

1- Install PackageA 

2- Install AppletAl 




2- RAPDU = 00 90 00 



5.5.11.3 Applet deletion 

Test Area Reference: Cre Uta Adel. 



5.5.11.3.1 



Conformance requirement 



The Applet deletion mechanism defined in "Java CardT"^ 2.2. 1 Runtime Environment Specification" ([3]) shall be used 
to delete the content from the UICC. 

5.5.11.3.1.1 Normal execution 

• CRRNl: Following a successful applet instance deletion, the Java Card RE shall delete the applet instance. 

• CRRN2: Following an unsuccessful applet instance deletion, the applet instance shall be selectable, and all 
objects owned by the applet shall remain unchanged. 
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• CRRN3: Following a successful applet instance deletion, it shall not be possible to select that applet, and no 
object owned by the applet can be accessed by any applet currently on the card or by a new applet created in 
the future. 



5.5.11.3.1.2 
No requirements. 

5.5.11.3.1.3 



Parameter errors 



Context errors 



• CRRCl: The deletion shall fail if any object owned by the applet instance is referenced from an object owned 
by another applet instance on the card. 

• CRRC2: The deletion shall fail if any object owned by the applet instance is referenced from a static field on 
any package on the card. 

• CRRC3: The deletion shall fail if an applet instance, belonging to the context of the applet instance being 
deleted, is active (selected) on the card. 

5.5.11.3.2 Test area files 

This clause uses 2 packages: 

uicc.test.catre.cre_uta_adel.cre_uta_adel_a 
uicc.test.catre.cre_uta_adel.cre_uta_adel_b 
Test Source: Test_Cre_Uta_Adel.java. 
Test Applet: Cre_Uta_Adel_A_l .j ava. 

Cre_Uta_Adel_A_2.j ava. 

Cre_Uta_Adel_A_3 .j ava. 

Cre_Uta_Adel_B_ 1 .j ava. 

Cre_Uta_Adel_B_2. Java. 
Cap File: cre_uta_adel_a.cap. 

cre_ut a_adel_b . c ap . 



5.5.11.3.3 



Test coverage 



CRR number 


Test case number 


CRRN1 


3,4 


CRRN2 


1,2,3 


CRRN3 


4,5 


CRRC1 


1 


CRRC2 


2 


CRRC3 


3 
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5.5.11.2.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 





1- Install packages PackageA then PackageB 

2- Install AppletAl, AppletA2, AppletBl 
and AppletB2 






1 


The deletion shall fail if any object owned by 

the applet instance is referenced from an 

object owned by another applet instance on 

the card 








1- Send an envelope Menu Selection to 
trigger AppletAl 


1- AppletAl is triggered 






2- AppletAl store the menu Id 








3- Send an envelope Menu Selection to 


3- AppletA2 is triggered 






trigger AppletA2 








4- AppletA2 gets a reference to the 








shareable interface to retrieve the menu 








Id used to trigger AppletAl 








5- Delete AppletAl 




5- SW shall be different 
from 90 00 




6- Send an envelope Menu Selection to 


6- AppletAl is triggered 






trigger AppletAl 








7- Send an envelope Menu Selection to 
trigger AppletA2 


7- AppletA2 is triggered 


7- SW = 90 00 




8- AppletA2 frees the reference to the 








shareable interface 








9- Delete AppletAl 








10- Install AppletAl 




9- SW = 90 00 




11- Send an envelope Menu Selection to 


1 1 - AppletAl is triggered 


10- RAPDU = 00 90 00 




trigger AppletAl 








12- AppletAl store the menu Id 








13- Send an envelope Menu Selection to 
trigger AppletB2 


13- AppletB2 is triggered 






14- AppletB2 gets a reference to the 








shareable interface to retrieve the menu 








Id used to trigger AppletAl 
15- Delete AppletAl 




1 5- SW shall be different 
from 90 00 




16- Send an envelope Menu Selection to 


16- AppletAl is triggered 






trigger AppletAl 








17- Send an envelope Menu Selection to 
trigger AppletB2 


17- AppletB2 is triggered 


1 7- SW = 90 00 




18- AppletB2 frees reference to the 








shareable interface 








19- Delete AppletAl 








20- Install AppletAl 




19-SW = 90 00 

20- RAPDU = 00 90 00 


2 


The deletion shall failed if any object owned by 

the applet instance is referenced from a static 

field on any package on the card 








1- Send an envelope Menu Selection to 
trigger AppletAl 


1 - AppletAl is triggered 






2- AppletAl store the menu Id 








3- Send an envelope Menu Selection to 








trigger AppletA2 







ETSI 



Release 6 



723 



ETSI TS 102 268 V6.0.0 (2007-03) 



4- AppletA2 gets a reference to the 
shareable interface and stores it in a 
static field of PackageA, then retrieves 
the menu Id used to trigger AppletAl 

5- Delete AppletA2 

6- Delete AppletAl 

7- Send an envelope Menu Selection to 
trigger AppletAl 

8- AppletAl frees the reference to the 
shareable interface 

9- Delete AppletAl 

10- Install AppletAl 

11- Send an envelope Menu Selection to 
trigger AppletAl 

12- AppletAl store the menu Id 

13- Send an envelope Menu Selection to 
trigger AppletB2 

14- AppletB2 gets a reference to the 
shareable interface and stores it in a 
static field of PackageB, then retrieves 
the menu Id used to trigger AppletAl 

15- Delete AppletB2 

16- Delete AppletAl 

17- Send an envelope Menu Selection to 
trigger AppletAl 

18- Send an envelope Menu Selection to 
trigger AppletBl 

19- AppletBl then frees the reference to 
the shareable interface 

20- Delete AppletAl 

21- Install AppletAl 



3- AppletA2 is triggered 



7- AppletAl is triggered 



11- AppletAl is triggered 



13- AppletB2 is triggered 



17- AppletAl is triggered 
18- AppletBl is triggered 



5- SW = 90 00 

6- SW shall be different 
from 90 00 



9- SW = 90 00 
10-RAPDU = 00 90 00 



15-SW = 90 00 

1 6- SW shall be different 
from 90 00 



20- SW = 90 00 
21-RAPDU = 00 90 00 
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3 


Deletion of an active applet instance 

1- Delete AppletBl 

2- Install AppletBl 

3- Open another channel and select 
AppletBl the new open channel 

4- Delete AppletBl on channel 

5- Select AppletBl on Channel 

6- Reset 




1-SW = 90 00 

2- RAPDU = 00 90 00 

3- RAPDU = opplet 
selected data> 90 00 

4- SW shall be different 
from 90 00 

5- RAPDU = <applet 
selected data> 90 00 


4 


Selection of a deleted applet instance 

1- Delete AppletBl 

2- Select AppletBl on Channel 

3- Install AppletBl 




1 - SW = 90 00 

2- SW shall be different 
from 90 00 

3- RAPDU = 00 90 00 


5 


Object owned by a deleted applet can't be 
accessed by other applets 

1- Delete AppletAl 

2- Send an envelope Menu Selection to 
trigger AppletBl 

3- AppletBl gets a reference to the 
shareable interface to retrieve the menu 
Id used to trigger AppletAl 


2- AppletBl is triggered 

3- An exception is tlirown 


1 - SW = 90 00 



5.5.11.4 Object deletion 

Test Area Reference: Cre_Uta_Odel. 

5.5.1 1 .4.1 Conformance requirement 

5.5.11.4.1.1 Normal execution 

• CRRNl: If an object deletion mechanism is supported then the one defined in "Java CardT"^ 2.2.1 Application 
Programming Interface Specification" ([2]) shall be used. 



5.5.11.4.1.2 
No requirements. 

5.5.11.4.1.3 
No requirements. 

5.5.11.4.2 
Test Script: 
Test Applet: 
Cap File: 



Parameter errors 
Context errors 
Test area files 

Test_Cre_Uta_Odel .j ava 
Cre_Uta_Odel_ 1 .j ava 
cre_uta_odel.cap 



ETSI 



Release 6 



725 



ETSI TS 102 268 V6.0.0 (2007-03) 



5.5.11.4.3 



Test coverage 



CRR number 


Test case number 


CRRN1 


1 



5.5.11.4.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Object deletion 

1- Applet calls 

JCSystem. isObjectDeletionSupported {) 


2- Returns TRUE 





5.5.12 Proactive Command Handling 
5.5.12.1 General behaviour 

Test Area Reference: Cre_Pch_Genb. 

5.5.12.1.1 Conformance requirement 

5.5.12.1.1.1 Normal execution 

• CRRNl: On the call to the send() method, the CAT Runtime Environment shall handle the transmission of the 
proactive command to the terminal, and the reception of the response. 

• CRRN2: The CAT Runtime Environment shall resume the Toolkit Applet execution on the return from the 
send() method. 



5.5.12.1.1.2 
No requkements. 

5.5.12.1.1.3 
No requirements. 

5.5.12.1.2 

None. 

5.5.12.1.3 



Parameter errors 



Context errors 



Test area files 



Test coverage 



CRR number 


Test case number 


CRRN1 


See test case 2 of 
Cre Hin Prhd 



5.5.12.1.4 
None. 



Test procedure 
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5.5.13 CAT Runtime Environment belnaviour 
5.5.13.1 Context 

Test Area Reference: Cre_Cat_Ctxt. 

5.5.13.1.1 Conformance requirement 

5.5.13.1.1.1 Normal execution 

• CRRN 1 : At the invocation of the processToolkit() method the context as defined in Java Card shall be set to 
the context of the Toolkit Applet. The previous context (context of the caller) shall be the context of the CAT 
Runtime Environment. 

• CRRN2: During the execution there might be other context switches, but at the return of the send() method the 
toolkit applet context is restored. 



5.5.13.1.1.2 
No requirements. 

5.5.13.1.1.3 
No requirements. 

5.5.13.1.2 

Test Source: 
Test Applet: 
Cap File: 

5.5.13.1.3 



Parameter errors 
Context errors 
Test area files 

Test_Cre_Cat_Ctxt.j ava. 
Cre_Cat_Ctxt_l .Java. 
cre_cat_ctxt.cap. 

Test coverage 



CRR number 


Test case number 


CRRN1 


Not Testable 


CRRN2 


see Cre Hin Enhd 



5.5.13.1.4 

Not applicable. 



Test procedure 



5.5.14 UICC and ADF File System Administration API 



5.5.14.1 AdminFile View 

Test Area Reference: Cre_Fsa_View 



5.5.14.1.1 



Conformance requirement 



5.5.14.1.1.1 Normal execution 

• CRRNl: AdminFileView objects follow the behaviour of FileView objects and inherit FileView functionality. 

• CRRN2: An AdminFileView object can be retrieved by invoking one of the getAdminFileView( ) methods 
defined in the AdminFileViewBuilder class. 
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• CRRN3: Each AdminFileView shall be given the access control privileges associated with the UICC or the 
corresponding ADF for the Applet. 

• CRRN4: The access control privileges are checked against the access rules defined in TS 102 221 [6] each 
time a method of the AdminFileView object is invoked. 



5.5.14.1.1.2 
No requirements. 

5.5.14.1.1.3 
No requirements. 

5.5.14.1.2 
None. 

5.5.14.1.3 



Parameter errors 



Context errors 



Test area files 



Test coverage 



CRR number 


Test case number 


CRRN1 


See API 4 Afv xxxx 


CRRN2 


See API 4 Afb xxxx 


CRRN3 


See Cre Tin Acdo 


CRRN4 


See Cre Tin Acdo 



5.5.14.1.4 
None. 



Test procedure 



5.5.14.2 AdminFile Access 

Test Area Reference: Cre_Fsa_Aacc. 
See API access. administration part. 
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Annex A (normative): 

Class and methods acronyms 

A.1 uicc.access package 



Interface / Class Name 


Acronyms 


FileView 


Fvw 


UlCCConstants 


Uct 


UlCCSystem 


Usy 


UICCException 


Uex 



A.1 .1 FileView methods 



Method Name 


Acronyms 


public void activateFile ( ) 


Actf 


public void deactivateFile ( ) 


Dacf 


public short increase (byte [ ] incr, short incrOffset, 
short incrLength, byte[] resp, short respOffset) 


Incr 


public short readBinary (short fileOffset, 
byte[] resp, short respOffset, short respLength) 


Redb 


public short readRecord (short recNumber, byte mode, 
short recOffset, byte[] resp, short respOffset, 
short respLength) 


Redr 


public short searchRecord (byte mode, 

short recordNum, short searchlndication, 

byte[] patt, short pattOffset, short pattLength, 

short [] response, short respOffset, 

short respLength) 


Sear 


public void select (byte sfi) 


SIctb 


public void select (short fid) 


SIcts 


public short select (short fid, byte[] fcp, 
short fcpOffset, short fcpLength) 


Slct_Bss 


public short status (byte [ ] fcp, short fcpOffset, 
short fcpLength) 


Stat 


public void updateBinary (short fileOffset, 
byte[] data, short dataOffset, short dataLength) 


Updb 


public void updateRecord (short recNumber, byte mode, 
short recOffset, byte[] data, short dataOffset, 
short dataLength) 


Updr 



A.1. 2 UlCCConstants 



Method Name 


Acronyms 


Constants 


Cnst 



A.1 .3 UlCCSystem methods 



Method Name 


Acronyms 


public static FileView 

getTheFileView ( javacard. framework. AID aid, 

byte event) 


Getfob 


public static FileView getTheFileView (byte [ ] buffer, 
short bOffset, byte bLength, byte event) 


Getf_Bsbb 


public static FileView getTheUICCView (byte event) 


Getfb 
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A. 1.4 UlCCException methods 



Method Name 


Acronyms 


public UlCCException (short reason) 


Coor 


public static void throwit (short reason) 


Thit 


Constants 


Cons 



A.2 uicc.toolkit package 



BERTLVEdit Handler 


Bte 


BERTLWiewHandler 


Btv 


EditHandler 


Edh 


Envelope Handler 


Enh 


EnvelopeResponseHandler 


Erh 


ProactiveHandler 


Pah 


ProactiveResponseHandler 


Prh 


Toolkit Const ants 


Tkc 


Toolkit Interface 


Tki 


ToolkitRegistry 


Tkr 


ViewHandler 


Vwh 


Envelope Handler System 


Ehs 


EnvelopeResponseHandler System 


Ers 


ProactiveHandler System 


Phs 


ProactiveResponseHandler System 


Prs 


TerminalProf ile 


Tep 


Toolkit Regis try System 


Trs 


Toolkit Except ion 


Tke 



A.2.1 BERTLVEditHandler methods 



Method Name 


Acronyms 


public void setTag(byte bBERTag) 


Sttg 






Inherited method name: EditHandler 




void appendArray (byte [ ] buffer, short offset, short 
length) 


Apda 


void appendTLV (byte tag, byte value) 


Aptibb 


void appendTLV (byte tag, byte[] value, short 
valueOffset, short valueLength) 


Aptlb_Bss 


void appendTLV (byte tag, byte[] valuel, short 
valuelOf f set , short valuelLength, byte[] value2, 
short value20f f set , short value2Length) 


Aptlb_Bss_Bss 


void appendTLV (byte tag, byte valuel, byte value2) 


Aptlbbb 


void appendTLV (byte tag, byte valuel, byte[] value2, 
short value20f f set, short value2Length) 


Aptlbb_Bss 


void appendTLV (byte tag, byte valuel, short value2) 


Aptlbbs 


void appendTLV (byte tag, short value) 


Aptlbs 


void appendTLV (byte tag, short valuel, short value2) 


Aptlbss 


void clear ( ) 


Cler 






Inherited method name: ViewHandler 




byte compareValue (short valueOffset, byte[] 
compareBuf f er, short compareOf f set, short 
compareLength) 


Cprv 


short copy (byte [] dstBuffer, short dstOffset, short 
dstLength) 


Copy 


short copyValue (short valueOffset, byte[] dstBuffer, 
short dstOffset, short dstLength) 


Cpyv 


byte f indAndCompareValue (byte tag, byte[] 
compareBuf fer, short compareOf f set ) 


Facrb_Bs 
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Method Name 


Acronyms 


byte f indAndCompareValue (byte tag, byte occurence, 
short valueOffset, byte[] compareBuf fer, short 
compareOf f set , short compareLength) 


Facrbbs_Bss 


short f indAndCopyValue (byte tag, byte[] dstBuffer, 
short dstOffset) 


Facyb_Bs 


short f indAndCopyValue (byte tag, byte occurence, 
short valueOffset, byte[] dstBuffer, short 
dstOffset, short dstLength) 


Facybbs_Bss 


byte findTLV(byte tag, byte occurrence) 


Find 


short getCapacity ( ) 


Gcap 


short getLengthO 


Glen 


byte getValueByte (short valueOffset) 


Gvby 


short getValueLength ( ) 


Gvie 


short getValueShort (short valueOffset) 


Gvsh 






Inherited method name: BERTLVViewHandler 




short getSize ( ) 


Gtsz 


byte getTagO 


Gttg 



A.2.2 BERTLVViewHandler methods 

Tests are done in inheriting interfaces BERTLVEditHandler and envelopeHandler. 

A.2.3 EditHandler methods 

Tests are done in inheriting interfaces EnvelopeResponseHandler and ProactiveHandler. 

A.2.4 EnvelopeHandler methods 



Method Name 


Acronyms 


Byte getChannelldentif ier ( ) 


Gcid 


Short getChannelStatus (byte channelldentif ier) 


Gcst 


Byte get Itemldentif ier ( ) 


Giid 






Inherited method name: BERTLVViewHandler 




short getSize ( ) 


Gtsz 


byte getTagO 


Gttg 






Inherited method name: ViewHandler 




byte compareValue (short valueOffset, byte[] 
compareBuf fer, short compareOf f set , short 
compareLength) 


Gprv 


short copy (byte [] dstBuffer, short dstOffset, short 
dstLength) 


Copy 


short copyValue (short valueOffset, byte[] dstBuffer, 
short dstOffset, short dstLength) 


Gpyv 


byte f IndAndCompareValue (byte tag, byte[] 
compareBuf fer, short compareOf f set ) 


Facrb_Bs 


byte f IndAndCompareValue (byte tag, byte occurence, 
short valueOffset, byte[] compareBuf fer, short 
compareOf f set , short compareLength) 


Facrbbs_Bss 


short f IndAndCopyValue (byte tag, byte[] dstBuffer, 
short dstOffset) 


Facyb_Bs 


short f indAndCopyValue (byte tag, byte occurence, 
short valueOffset, byte[] dstBuffer, short 
dstOffset, short dstLength) 


Facybbs_Bss 


byte findTLV(byte tag, byte occurrence) 


Find 


short getCapacity ( ) 


Gcap 


short getLengthO 


Glen 


byte getValueByte (short valueOffset) 


Gvby 


short getValueLength ( ) 


GvIe 


short getValueShort (short valueOffset) 


Gvsh 
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A.2.5 EnvelopeResponseHandler methods 



Method Name 


Acronyms 


void post (boolean value) 


Post 


void postAsBERTLV (boolean value, byte tag) 


Pabt 






Inherited method name: EditHandler 




void appendArray (byte [ ] buffer, short offset, short 
length) 


Apda 


void appendTLV (byte tag, byte value) 


Aptibb 


void appendTLV (byte tag, byte[] value, short 
valueOffset, short valueLength) 


Aptlb_Bss 


void appendTLV (byte tag, byte[] valuel, short 
valuelOf f set , short valuelLength, byte[] value2, 
short value20f f set, short value2Length) 


Aptlb_Bss_Bss 


void appendTLV (byte tag, byte valuel, byte value2) 


Aptlbbb 


void appendTLV (byte tag, byte valuel, byte[] value2, 
short value20f f set, short value2Length) 


Aptlbb_Bss 


void appendTLV (byte tag, byte valuel, short value2) 


Aptlbbs 


void appendTLV (byte tag, short value) 


Aptlbs 


void appendTLV (byte tag, short valuel, short value2) 


Aptlbss 


void clear ( ) 


Cler 






Inherited method name: ViewHandler 




byte compareValue (short valueOffset, byte[] 
compareBuf fer, short compareOf f set, short 
compareLength) 


Cprv 


short copy (byte [] dstBuffer, short dstOffset, short 
dstLength) 


Copy 


short copyValue (short valueOffset, byte[] dstBuffer, 
short dstOffset, short dstLength) 


Cpyv 


byte f indAndCompareValue (byte tag, byte[] 
compareBuf fer, short compareOf f set ) 


Facrb_Bs 


byte f IndAndCompareValue (byte tag, byte occurence, 
short valueOffset, byte[] compareBuf fer, short 
compareOf f set, short compareLength) 


Facrbbs_Bss 


short f indAndCopyValue (byte tag, byte[] dstBuffer, 
short dstOffset) 


Facyb_Bs 


short f IndAndCopyValue (byte tag, byte occurence, 
short valueOffset, byte[] dstBuffer, short 
dstOffset, short dstLength) 


Facybbs_Bss 


byte f indTLV (byte tag, byte occurrence) 


Find 


short getCapacity ( ) 


Gcap 


short getLengthO 


Glen 


byte getValueByte (short valueOffset) 


Gvby 


short getValueLength ( ) 


Gvie 


short getValueShort (short valueOffset) 


Gvsh 



A.2.6 ProactiveHandler methods 



Method Name 


Acronyms 


void init (byte type, byte qualifier, byte dstDevice) 


Init 


void initCloseChannel (byte bChannelld) 


lech 


void InitDisplayText (byte qualifier, byte dcs, 
byte[] buffer, short offset, short length) 


Indt 


void initGetlnkey (byte qualifier, byte dcs, byte[] 
buffer, short offset, short length) 


Ingk 


void initGetlnput (byte qualifier, byte dcs, byte[] 
buffer, short offset, short length, short 
minRespLength, short maxRespLength) 


Ingi 


void initMoreTime ( ) 


Inmt 


byte sendO 


Send 






Inherited method name: EditHandler 




void appendArray (byte [ ] buffer, short offset, short 
length) 


Apda 


void appendTLV (byte tag, byte value) 


AptIbb 


void appendTLV (byte tag, byte[] value, short 


Aptlb_Bss 
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valueOffset, short valueLength) 




void appendTLV (byte tag, byte[] valuel, short 
valuelOf f set, short valuelLength, byte[] value2, 
short value20f f set, short value2Length) 


Aptlb_Bss_Bss 


void appendTLV (byte tag, byte valuel, byte value2) 


Aptlbbb 


void appendTLV (byte tag, byte valuel, byte[] value2, 
short value20f f set , short value2Length) 


Aptlbb_Bss 


void appendTLV (byte tag, byte valuel, short value2) 


Aptlbbs 


void appendTLV (byte tag, short value) 


Aptlbs 


void appendTLV (byte tag, short valuel, short value2) 


Aptlbss 


void clear 


Cler 






Inherited method name: ViewHandler 




byte compareValue (short valueOffset, byte[] 
compareBuf fer, short compareOf f set , short 
compare Length) 


Cprv 


short copy (byte [] dstBuffer, short dstOffset, short 
dstLength) 


Copy 


short copyValue (short valueOffset, byte[] dstBuffer, 
short dstOffset, short dstLength) 


Cpyv 


byte f indAndCompareValue (byte tag, byte[] 
compareBuf fer, short compareOf f set ) 


Facrb_Bs 


byte f IndAndCompareValue (byte tag, byte occurence, 
short valueOffset, byte[] compareBuf fer, short 
compareOf f set, short compareLength) 


Facrbbs_Bss 


short f indAndCopyValue (byte tag, byte[] dstBuffer, 
short dstOffset) 


Facyb_Bs 


short f IndAndCopyValue (byte tag, byte occurence, 
short valueOffset, byte[] dstBuffer, short 
dstOffset, short dstLength) 


Facybbs_Bss 


byte findTLV(byte tag, byte occurrence) 


Find 


short getCapacity ( ) 


Gcap 


short getLengthO 


Glen 


byte getValueByte (short valueOffset) 


Gvby 


short getValueLength ( ) 


Gvie 


short getValueShort (short valueOffset) 


Gvsh 



A.2.7 ProactiveResponseHandler methods 



Method Name 


Acronyms 


short copyAdditionallnformation (byte [ ] dstBuffer, 
short dstOffset, short dstLength) 


Cpai 


short copyChannelData (byte [ ] dstBuffer, short 
dstOffset, short dstLength) 


Cchd 


short copyTextString (byte [ ] dstBuffer, short 
dstOffset) 


Opts 


short getAdditionalInf ormationLength ( ) 


Gtil 


byte getChannelldentif ier ( ) 


Gcid 


short getChannelStatus (byte channelldentif ier) 


Gcst 


byte getCeneralResult ( ) 


Gtgr 


byte getltemldentif ier ( ) 


Gtii 


byte getTextStringCodingScheme ( ) 


Gtcs 


short getTextStringLength ( ) 


GttI 






Inherited method name: ViewHandler 




byte compareValue (short valueOffset, byte[] 
compareBuf fer, short compareOf f set, short 
compareLength) 


Cprv 


short copy (byte [] dstBuffer, short dstOffset, short 
dstLength) 


Copy 


short copyValue (short valueOffset, byte[] dstBuffer, 
short dstOffset, short dstLength) 


Cpyv 


byte f IndAndCompareValue (byte tag, byte[] 
compareBuf fer, short compareOf f set ) 


Facrb_Bs 


byte f IndAndCompareValue (byte tag, byte occurence, 
short valueOffset, byte[] compareBuf fer, short 
compareOf f set , short compareLength) 


Facrbbs_Bss 


short f IndAndCopyValue (byte tag, byte[] dstBuffer, 
short dstOffset) 


Facyb_Bs 
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short f indAndCopyValue (byte tag, byte occurence, 
short valueOffset, byte[] dstBuffer, short 
dstOffset, short dstLength) 


Facybbs_Bss 


byte findTLV(byte tag, byte occurrence) 


Find 


short getCapacity ( ) 


Gcap 


short getLengthO 


Glen 


byte getValueByte (short valueOffset) 


Gvbys 


short getValueLength ( ) 


Gvie 


short getValueShort (short valueOffset) 


Gvsh 



A.2.8 ToolkitConstants methods 



Method Name 


Acronyms 


Constants 


Cons 



A.2.9 Toolkitlnterface methods 



Method Name 


Acronyms 


void processToolkit (short event) 


Prtk 



A.2.10 ToolkitRegistry methods 



Method Name 


Acronyms 


byte allocateServiceldentif ier ( ) 


Asid 


byte allocateTimer ( ) 


Atim 


void changeMenuEntry (byte id, byte[] menuEntry, 
short offset, short length, byte nextAction, boolean 
helpSupported, byte IconQualif ier, short 
icon I dent if ier) 


Cmet 


void clearEvent (short event) 


Cevt 


public void deregisterFileEvent (short event, byte[] 
baFileList, short sOffsetl, short sLengthl, byte[] 
baADFAid, short sOffset2, byte bLength2) 


Drfes_Bss_Bss 


public void deregisterFileEvent (short event, 
FileView aFileView) 


Drfeso 


void disableMenuEntry (byte id) 


Dmet 


void enableMenuEntry (byte id) 


Emet 


short getPollInterval ( ) 


Gpol 


byte initMenuEntry (byte [ ] menuEntry, short offset, 
short length, byte nextAction, boolean 
helpSupported, byte IconQualif ier, short 
iconldentifier) 


Imet 


boolean isEventSet (short event) 


levs 


public void registerFileEvent (short event, byte[] 
baFileList, short sOffsetl, short sLengthl, byte[] 
baADFAid, short sOffset2, byte bLength2) 


Rgfes_Bss_Bsb 


public void registerFileEvent (short event, FileView 
aFileView) 


Rgfeso 


void releaseServiceldentif ier (byte 
service Identifier) 


Rsid 


void releaseTimer (byte timerldentif ier) 


Rtim 


void requestPollInterval (short duration) 


Rpol 


void setEvent (short event) 


Sevt 


void setEventList (short [ ] eventList, short offset, 
short length) 


SevI 


public void setMenuEntryTextAttribute (byte id, 
byte[] textAttribute, short offset, short length) 


Smta 
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A.2.1 1 ViewHandler methods 

Tests are done in inheriting interfaces EnvelopeHandler, EnvelopeResponseHandler, ProactiveHandler and 
ProactiveResponseHandler. 

A.2.1 2 EnvelopeHandlerSystem methods 



Method Name 


Acronyms 


public static EnvelopeHandler getTheHandler ( ) 


Gthd 



A.2.1 3 EnvelopeResponseHandlerSystem methods 



Method Name 


Acronyms 


public static EnvelopeResponseHandler getTheHandler { ) 


Gthd 



A.2.1 4 ProactiveHandlerSystem methods 



Method Name 


Acronyms 


public static ProactiveHandler getTheHandler ( ) 


Gthd 



A.2.1 5 ProactiveResponseHandlerSystem methods 



Method Name 


Acronyms 


public static ProactiveResponseHandler getTheHandler ( ) 


Gthd 



A.2.1 6 TerminalProfile methods 



Method Name 


Acronyms 


static boolean check (byte index) 


Checb 


static boolean check (byte [] mask, short offset, 
short length) 


Chec_Bss 


static boolean check (short index) 


Checs 


static short copy (short startOffset, byte[] 
dstBuffer, short dstOffset, short dstLength) 


Copy 


static short getValue (short idx) 


Gvals 


static short getValue (short indexMSB, short 
indexLSB) 


Gvaiss 



A.2.1 7 ToolkitRegistrySystem methods 



Method Name 


Acronyms 


public static ToolkitRegistry getEntryO 


Gety 



A.2.1 8 ToolkitException methods 



Method Name 


Acronyms 


Constants 


Cons 


public ToolkitException (short reason) 


Coor 


public static void throwit (short reason) 


Thit 
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A.3 uicc.system package 



Handler Builder 


Hbd 


UlCCPlatform 


Upt 



A.3.1 BERTLVEditHandler methods 



Method Name 


Acronyms 


static ViewHandler buildTLVHandler (byte type, short 
capacity) 


Bthdbs 


static ViewHandler buildTLVHandler (byte type, short 
capacity, byte[] buffer, short bOffset, short 
bLength) 


Bthdbs_Bss 



A.3.2 UlCCPlatform methods 



Method Name 


Acronyms 


public static byte[] getTheVolatileByteArray ( ) 


Gvba 



A.4 uicc.access.fileadministration package 



Interface / Class Name 


Acronyms 


AdminFileView 


Afv 


AdminFileViewBuilder 


Afb 


AdminException 


Aex 



A.4.1 AdminFileView methods 



Method Name 


Acronyms 


public void createFile (ViewHandler viewHandler) 


Crtf 


public void deleteFile (short fid) 


DItf 


public void resizeFile (ViewHandler viewHandler) 


Rszf 






Inherited method name: FileView 




public void activateFile ( ) 


Actf 


public void deactivateFile ( ) 


Dacf 


public short increase (byte [ ] incr, short incrOffset, 
short incrLength, byte[] resp, short respOffset) 


Incr 


public short readBinary (short fileOffset, 
byte[] resp, short respOffset, short respLength) 


Redb 


public short readRecord (short recNumber, byte mode, 
short recOffset, byte[] resp, short respOffset, 
short respLength) 


Redr 


public short searchRecord (byte mode, 

short recordNum, short searchlndication, 

byte[] patt, short pattOffset, short pattLength, 

short [ ] response, short respOffset, 

short respLength) 


Sear 


public void select (byte sfi) 


SIctb 


public void select (short fid) 


SIcts 


public short select (short fid, byte[] fcp, 
short fcpOffset, short fcpLength) 


Slct_Bss 


public short status (byte [ ] fcp, short fcpOffset, 
short fcpLength) 


Stat 


public void updateBinary (short fileOffset, 
byte[] data, short dataOffset, short dataLength) 


Updb 


public void updateRecord (short recNumber, byte mode, 
short recOffset, byte[] data, short dataOffset, 
short dataLength) 


Updr 
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A.4.2 AdminFileViewBuilder methods 



Method Name 


Acronyms 


public static AdminFileView 
getTheUICCAdminFileView (byte bType) 


Gtafb 


public static AdminFileView 

getTheAdminFileView (byte [ ] buffer, short bOffset, 

byte bLength, byte bType) 


Gtaf_Bsbb 


public static AdminFileView 

getTheAdminFileView ( javacard. framework .AID aid, byte 

bType) 


Gtafob 



A.4.3 AdminException methods 



Method Name 


Acronyms 


Constants 


Cons 


public AdminException (short reason) 


Coor 


public static void throwit (short reason) 


Thit 



A.5 Acronyms for CAT Runtime Environment tests 



Minimum liandler availability 


Mha 


Handler integrity 


Hin 


Applet triggering 


Apt 


Proactive command sending by the CAT Runtime Environment 


Pes 


Exception handling 


Exh 


Envelope response posting 


Erp 


Toolkit installation 


Tin 


Dice file access 


Ufa 


Other parts transferred from API to CAT RE 


Api 


Registration 


Reg 


UICC toolkit applet 


Ufa 


Proactive command handling 


Pch 


CAT Runtime Environment behaviour 


Cat 



A.5.1 Minimum handler availability 



Method Name 


Acronyms 


ProactiveHandler 


Pahd 


ProactiveResponseHandler 


Prhd 


EnvelopeHandler 


Enhd 


EnvelopeResponseHandler 


Erhd 



A. 5. 2 Handler integrity 



Method Name 


Acronyms 


ProactiveHandler 


Pahd 


ProactiveResponseHandler 


Prhd 


EnvelopeHandler 


Enhd 


EnvelopeResponseHandler 


Erhd 
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A. 5. 3 Applet triggering 



Method Name 


Acronyms 


General behaviour 


Genb 


EVENT PROFILE DOWNLOAD 


Epdw 


EVENT MENU SELECTION 


Emse 


EVENT MENU SELECTION HELP REQUEST 


Emsh 


EVENT CALL CONTROL BY NAA 


Eccn 


EVENT TIMER EXPIRATION 


Etex 


EVENT EVENT DOWNLOAD MT CALL 


Edmc 


EVENT EVENT DOWNLOAD CALL CONNECTED 


Edcc 


EVENT EVENT DOWNLOAD CALL DISCONNECTED 


Edcd 


EVENT EVENT DOWNLOAD LOCATION STATUS 


Edis 


EVENT EVENT DOWNLOAD USER ACTIVITY 


Edua 


EVENT EVENT DOWNLOAD IDLE SCREEN AVAILABLE 


Edis 


EVENT EVENT DOWNLOAD CARD READER STATUS 


Edcr 


EVENT UNRECOGNIZED ENVELOPE 


Euev 


EVENT STATUS COMMAND 


Estc 


EVENT EVENT DOWNLOAD LANGUAGE SELECTION 


Edig 


EVENT EVENT DOWNLOAD BROWSER TERMINATION 


Edbt 


EVENT FIRST COMMAND AFTER ATR 


Efca 


EVENT EVENT DOWNLOAD DATA AVAILABLE 


Edda 


EVENT EVENT DOWNLOAD CHANNEL STATUS 


Edcs 


EVENT EVENT DOWNLOAD ACCESS TECHNOLOGY CHANGE 


Edat 


EVENT EVENT DOWNLOAD DISPLAY PARAMETER CHANGED 


Eddp 


EVENT EVENT DOWNLOAD LOCAL CONNECTION 


Edic 


EVENT APPLICATION DESELECT 


Fade 


EVENT PROACTIVE HANDLER AVAILABLE 


Epha 


EVENT EVENT DOWNLOAD NETWORK SEARCH MODE CHANGE 


Edns 


EVENT EVENT DOWNLOAD BROWSING STATUS 


Edbs 



A.5.4 



Proactive command sending by the CAT Runtime 
Environment 



Method Name 


Acronyms 


System Proactive Commands 


Spec 


Interaction with UICC commands 


Igco 


Proactive Command Control 


Pcco 



A. 5. 5 Exception handling 



Method Name 


Acronyms 


General Behaviour 


Genb 


Interaction with Multiple Triggering 


Imtg 



A. 5. 6 Envelope response posting 



Method Name 


Acronyms 


EVENT CALL CONTROL BY NAA 


Eccn 


EVENT UNRECOGNIZED ENVELOPE 


Euen 


General Behaviour 


Genb 



A. 5. 7 Toolkit installation 



Method Name 



Acronyms 
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General Behaviour 


Genb 


Timers Allocation 


Tmal 


Item Identifier 


Itid 


Item Position 


Itpo 


IVIaximum Text Length for a menu entry 


Mime 


Maximum number of menu entries 


Nbme 


Access Domain 


Acdo 


Priority Level 


Priv 


Channel Allocation 


Ghal 


IVIinimum Security Level 


Mslv 


TAR Value(s) of the Toolkit Application instance 


Tarv 


Services Allocation 


Sval 



A.5.8 UICC file access 



Method Name 


Acronyms 


File View 


View 


File Access 


Face 



A.5.9 Other parts transferred from API to CAT RE 



Method Name 


Acronyms 


A handler is a temporary JCRE Entry Point object 


Hepo 


Transaction 


Tran 


Timer Id between Applets 


Tmid 



A. 5. 10 Registration 



Method Name 


Acronyms 


Event registration 


Evtr 



A.5.11 UICC toolkit applet 



Method Name 


Acronyms 


Data and function sharing 


Dafs 


Package deletion 


Pdel 


Applet deletion 


Adel 


Object deletion 


Odel 



A.5.12 Proactive command handling 



Method Name 


Acronyms 


General behaviour 


Genb 



A.5.13 CAT Runtime Environment behaviour 



Method Name 


Acronyms 


Context 


Ctxt 
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Annex B (normative): 
Global prepersonalization 



This annex defines the file systems used to pass the test suite. It is composed of the UICC File System Server 
(including MF and all DFs and EFs that are located under the MF) and of two Application Dedicated Files System 
Servers, ADFl and ADF2. 

ADFl and ADF2 shall use the following AIDs (as defined in section "4.7 AID Coding"): 

• ADFl : AO 00 00 00 09 00 05 FF FF FF FF 89 EO 00 00 02 

• ADF2: AO 00 00 00 09 00 05 FF FF FF FF 89 DO 00 00 02 

Under the MF, the mandatory files defined in TS 102 221 [6] are present, as the DFtelecom with the EFsume as defined 
in TS 102 222 [8] and some other files necessary for the tests. 

The files defined for ADFl and ADF2 are only necessary for the tests. 

All files are shareable if not specified otherwise. 

Except if specified the access conditions on DFs shall be set to ALWAYS for all commands. 

The global directory structures are defined in figures B.l to B.3: 
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MF 
'3F0O' 






















1 




1 










1 




1 






DFxELEGOM 

'7F10' 




DFtest 
7F4A 




EFuicc 
'2FE4' 




EFqir 
'2F00' 




EFpL 
'2F05' 




EFjcciD 
'2FE2' 




EFarr 

^2F05' 


































EFguME 

'6F54' 


























EFtnr 
'6F01' 




EFxHD 

'6F02' 




EFxARu 
'6F03' 




EFcNR 
'5F04' 




EFcNu 
'6F05' 


























































DFsuB xEST 

'5F10' 






EFcNic 
'5F1C' 




EFcHDE 

'5F07' 




EFcNAC 

'6F08' 




EFcARu 
'6F09' 




EFlnr 
'6F0A' 




















































EFjaa 
'4F10' 






EFtNu 
'5F0B' 




EFlaru 
'6F0C' 




EFciNA 

'6F0D' 




EFxRAc 
'6F0E' 




EFxdac 
'6F0F' 






















































EFciAc 
'5F10' 




EFciAA 

'5F11' 




EFcNRA 

'6F12' 




EFcuAC 
'5F13' 




EFxAAC 

'6F14' 




















































EFlada 
'6F15' 




EFxAAA 

'6F16' 




EFlrua 
'6F17' 




EFlupc 
'6F18' 




EFnosh 
'6F19' 






































1 












EFlsea 
'6F1A' 




EFcsEA 

'6F1B' 




EFxERM 

'6F30' 




DFxERM 

'5F30' 




















































EFlarri 
' 5FA1 ' 




EFlarr2 

' 6FA2 ' 




EFlarr3 

' 6FA3 ' 




EFlarr4 

' 6FA4 ' 




EFlarrs 
'6FA5' 




















































EFxARRl 

'6FB1' 




EFxARR2 

'6FB2' 




EFxARR3 

'6FB3' 




EFxARR4 

'5FB4' 




EFxarr5 

'6FB5' 




















































EFcARRi 
'6FC1' 




EFcARR2 

'6FC2' 




EFcARR3 

'6FC3' 




EFcARR4 

'6FC4' 




EFcARR5 

'6FC5' 




























































DFarri 

'5F11' 




DFarr2 

'5F12' 




DFarrb 

'5F13' 




DFarr4 

'5F14' 




DFarrs 

'5F15' 


































EF-TARix 

'4F11' 




EFxAR2T 

'4F12' 




EFxAR3T 

'4F13' 




EFxAR4T 

'4F14' 




EFxARST 

'4F15' 



NOTE: Files with shaded bacl<ground are mandatory and defined in TS 102 221 [6]. 

Figure B.1 : File identifiers and directory structures under MF 
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ADFl 

' XX. ..XX ' 








































DFxELECOM 

'7F10' 




DFtest 
'7F4A' 




EFuicc 
'2FE4' 




EFftRR 

^6F06' 




























EFsuME 

'6F54' 




























EFxHR 

'6F01' 




EFxNu 
'6F02' 




EFxARu 
'6F03' 




EFcNR 
'6F04' 




EFcNu 
'6F05' 








































1 




1 




1 




1 






DFsuB TEST 

'5F10' 






EFcmc 
'6F1C' 




EFcHDE 

'6F07' 




EFcNAC 

'6F08' 




EFcARu 
'6F09' 




EFlhr 
' 6F0A' 




















































EFxaa 
'4F10' 






EFlnu 
'6F0B' 




EFlaru 
'6F0C' 




EFciNA 

'6F0D' 




EFxRAc 
'6F0E' 




EFxDAC 

'6F0F' 






















































EFciAc 
'6F10' 




EFciAA 

'6F11' 




EFcNRA 

'6F12' 




EFcuAC 
'6F13' 




EFxAAC 

'6F14' 






























1 


















EFlada 
'6F15' 




EFxAAA 

'6F16' 




EFlrua 
'6F17' 




EFlupc 
'6F18' 




EFnosh 
'6F19' 


















































EFlsea 
'6F1A' 




EFcsEA 

'6F1B' 




EFxERH 

'6F30' 




DFxERM 

'5F30' 






























1 




1 




1 




1 










EFlarri 
' 6FA1 ' 




EFlarr2 
' 6FA2 ' 




EFlarr3 

' 6FA3 ' 




EFlarr4 
' 6FA4 ' 




EFlarr5 

'6FA5' 




















































EFxARRi 
'6FB1' 




EFxARR2 

'6FB2' 




EFxARR3 

'6FB3' 




EFxARR4 

'6FB4' 




EFxARRS 
'6FB5' 




















































EFcaRRi 
'6FC1' 




EFcARR2 

'6FC2' 




EFcARR3 

'6FC3' 




EFcARR4 

'6FC4' 




EFcARRS 
'6FC5' 




























































DFaRRi 
'5F11' 




DFaRR2 
'5F12' 




DFaRR3 
'5F13' 




DFaRR4 
'5F14' 




DFarrs 

'5F15' 


































EFxARlT 

'4F11' 




EFxAR2T 

'4F12' 




EFxAR3T 

'4F13' 




EFxAR4T 

'4F14' 




EFxAR5T 

'4F15' 



Figure B.2: File identifiers and directory structures under ADF1 
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ADF2 

' XX. ..XX ' 




























EFuicc 
'2FE4' 




DFtest 
'7F4A' 




DFaDF2 
'7F4B' 
















DFsuB TEST 

'5F10' 














EFxaA 
'4F10' 





Figure B.3: File identifiers and directory structures under ADF2 

Application PIN 1 (Global PIN 1) shall be associated to ADFl. 

Second Application PIN 1 (Local PIN 1) shall be associated to ADFl. 

The value for Application PIN 1 (Global PIN 1) shall be "0x31 0x31 0x31 0x31 OxFF OxFF OxFF OxFF" and its state 
shall be 'disabled' during test applets execution. 

The value for Second Application PIN l(Local PIN 1) shall be "0x31 0x32 0x33 0x34 OxFF OxFF OxFF OxFF" and its 
state shall be 'enabled' during test applets execution. 

The value for ADMl shall be "0x31 0x31 0x31 0x31 0x31 0x31 0x31 0x31" and its state shall be 'enabled' during test 
applets execution. 

The value for ADM2 shall be "0x32 0x32 0x32 0x32 0x32 0x32 0x32 0x32" and its state shall be 'enabled' during test 
applets execution. 



B.1 UICC file system server mandatory pre- 
personalization 

Table B.l shows the mandatory pre-personalization, the file system and the files' content, that the test UICC cards shall 
contain. 

Table B.1 



Name 


Identifier 


Default Value 


Special Features 


EFicciD 


2FE2 


OF FF FF FF FF FF FF FF FF FF 


This value is not compliant with 
ETSITS102 221 [6] 


EFdir 


2F00 


Record 1: 61 12 4F 10 AID_1 
Record 2: 61 12 4F 10 AID_2 




EFPL 


2F05 


01 FF 




thsume 


6F54 


85 09 55 49 43 43 20 54 45 53 54 FF 

FF FF FF FF FF 


Under DF Telecom, compliant with 
ETSITS102 222[8] 



MF 



EF ICCID 

EFDIR 

EFPL 

DF TELECOM 



EF SUME 
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B.2 UICC file system server test default pre- 
personalization 

Figure B.l shows the additional pre-personahzation, the file system and files' content under the Master File, that the test 
UICC card shall contain. 



B.2.1 EFuicc (UICC Test EF) 



IVIF 



EF UICC 





Identifier: '2FE4' Structure: transparent 


IVIandatory 




File size: 3 bytes | Update activity 


: low 


Access Conditions: 
READ ALWAYS 
UPDATE ALWAYS 
DEACTIVATE ALWAYS 
ACTIVATE ALWAYS 


Bytes 


Description 


Default Value 


M/0 


Length 


1 to 3 


Test Data 


AA AA AA 


M 


3 bytes 



B.2.2 EFarr (UICC Test Access Rules EF) 



IVIF 



EFARR 



Identifier: '2F06' Structure: Linear fixed 


Optional 


SFI : none 




Record length : n bytes 


Update activity: low 


Access Conditions: 
READ ALWAYS 
UPDATE ALWAYS 
DEACTIVATE ALWAYS 
ACTIVATE ALWAYS 


Bytes 


Description 


Default Value 


M/0 


Length 


1 ton 


Access Rule 1 


Always for all commands 


M 


n bytes 


n+1 to 2n 


Access Rule 2 


Never for all commands 


M 


n bytes 


2n+1 to 3n 


Access Rule 3 


Global PIN1 & ADM1 for all commands 


M 


n bytes 


3n+1 to 4n 


Access Rule 4 


Global PIN1 1 ADIVII for all commands 


M 


n bytes 


4n+1 to 5n 


Access Rule 5 


ADIV12 for all commands 


M 


n bytes 
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Access rules definition: 



Record 
nb 


Delete selft 


Terminat 

card 

Usage/ 

Terminate 

DF 


Activate 
File 


Deactivate 
File 


Create File 

(DF 
creation) 


Create File 

(EF 
creation) 


Delete File 
(child) 




Delete File 


Terminate 
EF 


Activate 
File 


Deactivate 
File 


Write 
Binary, 

Write 
Record, 
Append 
Record 


Update 
Binary, 
Update 
Record, 
Erase 
Binary 


Read 
binary. 

Read 
Record, 
Search 
Binary, 
Search 
Record 


Increase, 
resize 


1 


Always 


Always 


Always 


Always 


Always 


Always 


Always 


Always 


2 


Never 


Never 


Never 


Never 


Never 


Never 


Never 


Never 


3 


Global PIN1 
&ADM1 


Global PIN1 
&ADM1 


Global PIN1 
&ADM1 


Global PIN1 
&ADM1 


Global PIN1 
&ADM1 


Global PIN1 
&ADM1 


Global PIN1 
&ADM1 


Global PIN1 
&ADM1 


4 


Global PIN1 
1 ADM1 


Global PIN1 
1 ADM1 


Global PIN1 
1 ADM1 


Global PIN1 
1 ADM1 


Global PIN1 
1 ADM1 


Global PIN1 
1 ADM1 


Global PIN1 
1 ADM1 


Global PIN1 
1 ADM1 


5 


ADM2 


ADM2 


ADM2 


ADM2 


ADM2 


ADM2 


ADM2 


ADM2 



B.2.3 DFjEST (UICC Access Tests DF) 



Identifier: 7F4A' 
MF 



DF TEST 



B.2.3. 1 EFtnr (Transparent Never Read) 



MF 



DETEST 



EFTNR 





Identifier: '6F01' 1 Structure: transparent 


IVIandatory 


SFI:'01' 




File size: 3 bytes 


Update activity 


: low 


Access Conditions: 

READ NEVER 

UPDATE ALWAYS 

DEACTIVATE ALWAYS 

ACTIVATE ALWAYS 


Bytes 


Description 


Default Value 


M/0 


Length 


1 to 3 


Test Data 


AA AA AA 


M 


3 bytes 
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B.2.3.2 EFtnu (Transparent Never Update) 



MF 



DF TEST 



EFTNU 





Identifier: '6F02' | Structure: transparent 


IVIandatory 


SFI: '02' 




File size: 3 bytes 


Update activity 


: low 


Access Conditions: 

READ ALWAYS 

UPDATE NEVER 

DEACTIVATE ALWAYS 

ACTIVATE ALWAYS 


Bytes 


Description 


Default Value 


M/0 


Length 


1 to 3 


Test Data 


55 55 55 


M 


3 bytes 



B.2.3.3 EFtaru (Transparent Always Read and Update) 



MF 



DFTEST 



EF TARU 





Identifier: '6F03' 1 Structure: transparent 


IVIandatory 


SFI: '03' 




File size: 260 bytes 


Update activity 


: low 


Access Conditions: 
READ ALWAYS 
UPDATE ALWAYS 
DEACTIVATE ALWAYS 
ACTIVATE ALWAYS 


Bytes 


Description 


Default Value 


M/0 


Length 


1 to 260 


Test Data 


FF... FF 


M 


260 bytes 



B.2.3.4 EFcNR (Cyclic Never Read) 



MF 



DF TEST 



EFCNR 



Identifier: '6F04' 


1 Structure: cyclic 


1 


Mandatory 


SFI: '04' 




Record length: 3 bytes 


Update activity: high 


Access Conditions: 
READ NEVER 
UPDATE ALWAYS 
INCREASE ALWAYS 
DEACTIVATE ALWAYS 
ACTIVATE ALWAYS 


Logical Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


00 00 00 


M 


3 bytes 


2 


Test Data 


00 00 00 


M 


3 bytes 
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B. 2.3.5 EFcNu (Cyclic Never Update) 

IVIF 



DFTEST 



EFCNU 



Identifier: '6F05' 


1 Structure: cyclic 


1 


Mandatory 


SFI: '05' 




Record length: 3 bytes 


Update activity: high 


Access Conditions: 

READ ALWAYS 

UPDATE NEVER 

INCREASE NEVER 

DEACTIVATE ALWAYS 

ACTIVATE ALWAYS 


Logical Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


00 00 00 


M 


3 bytes 


2 


Test Data 


00 00 00 


M 


3 bytes 



B.2.3.6 EFcNic (Cyclic Never Increase) 

MF 



DF TEST 



EFCNIC 



Identifier: '6F1C' 


Structure: cyclic 


1 


Mandatory 


Record length: 3 bytes 


1 Update activity: 


high 


Access Conditions: 






READ 


ALWAYS 






UPDATE 


ALWAYS 






INCREASE 


NEVER 






DEACTIVATE 


ALWAYS 






ACTIVATE 


ALWAYS 






Logical Record 


Description 


Default Value 


M/0 


Length 


Number 










1 


Test Data 


00 00 00 


M 


3 bytes 


2 


Test Data 


00 00 00 


M 


3 bytes 



B.2.3.7 EFcNDE (Cyclic Never Deactivate) 

MF 



DF TEST 



EFCNDE 
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Identifier: '6F07 


Structure: cyclic 


1 


IVIandatory 


Record length: 3 bytes 


1 Update activity: high 


Access Conditions: 






READ 


ALWAYS 






UPDATE 


ALWAYS 






INCREASE 


ALWAYS 






DEACTIVATE 


NEVER 






ACTIVATE 


ALWAYS 






Logical Record 


Description 


Default Value 


M/0 


Length 


Number 










1 


Test Data 


00 GO GO 


M 


3 bytes 


2 


Test Data 


00 GG GG 


M 


3 bytes 



B. 2.3.8 EFcNAc (Cyclic Never Activate) 

MF 



DF TEST 



EF CNAC 



Identifier: '6F08' 


Structure: cyclic 


1 


Mandatory 


Record length: 3 bytes 


1 Update activity: high 


Access Conditions: 






READ 


ALWAYS 






UPDATE 


ALWAYS 






INCREASE 


ALWAYS 






DEACTIVATE 


ALWAYS 






ACTIVATE 


NEVER 






Logical Record 


Description 


Default Value 


M/0 


Length 


Number 










1 


Test Data 


00 GG GG 


M 


3 bytes 


2 


Test Data 


00 GG GG 


M 


3 bytes 



B. 2.3.9 EFcARu (Cyclic Always Read and Update) 



MF 



DF TEST 



EF CARU 



Identifier: '6F09' 


Structure: cyclic 


1 


Mandatory 


Record length: 3 bytes 


1 Update activity: high 


Access Conditions: 






READ 


ALWAYS 






UPDATE 


ALWAYS 






INCREASE 


ALWAYS 






DEACTIVATE 


ALWAYS 






ACTIVATE 


ALWAYS 






Logical Record 


Description 


Default Value 


M/0 


Length 


Number 










1 


Test Data 


55 55 55 


M 


3 bytes 


2 


Test Data 


AA AA AA 


M 


3 bytes 
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B. 2.3. 10 EFlnr (Linear Fixed Never Read) 



IVIF 



DF TEST 



EFLNR 



Identifier: '6F0A' 


Structure: linear fixed 


Mandatory 


Record length: 4 bytes 


1 Update activity: 


low 


Access Conditions: 

READ NEVER 

UPDATE ALWAYS 

DEACTIVATE ALWAYS 

ACTIVATE ALWAYS 


Logical Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data - Record 1 


FF FF FF FF 


M 


4 bytes 


2 


Test Data - Record 2 


FF FF FF FF 


M 


4 bytes 



B.2.3.1 1 EFlnu (Linear Fixed Never Update) 

MF 



DF TEST 



EFLNU 



Identifier: '6F0B' 


Structure: linear fixed 


Mandatory 


Record length: 4 bytes 


1 Update activity: 


low 


Access Conditions: 

READ ALWAYS 

UPDATE NEVER 

DEACTIVATE ALWAYS 

ACTIVATE ALWAYS 


Logical Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data - Record 1 


FF FF FF FF 


M 


4 bytes 


2 


Test Data - Record 2 


FF FF FF FF 


M 


4 bytes 



B.2.3.1 2 EFlaru (Linear Fixed Always Read and Update) 



MF 



DF TEST 



EF LARU 



Identifier: '6F0C' 


Structure: linear fixed 


Mandatory 


Record length: 4 bytes 


1 Update activity: 


low 


Access Conditions: 
READ ALWAYS 
UPDATE ALWAYS 
DEACTIVATE ALWAYS 
ACTIVATE ALWAYS 


Logical Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data - Record 1 


55 55 55 55 


M 


4 bytes 


2 


Test Data - Record 2 


AA AA AA AA 


M 


4 bytes 
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B. 2.3. 13 EFciNA (Cyclic Increase Not Allowed) 

IVIF 



DFTEST 



EFCINA 



Identifier: '6F0D' 


1 


Structure: cyclic | 


IVIandatory 


Record length: 3 bytes 




Update activity: high 






Access Conditions: 
READ 
UPDATE 
INCREASE 
DEACTIVATE 
ACTIVATE 


ALWAYS 
ALWAYS 
NEVER 
ALWAYS 
ALWAYS 




Logical Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


00 GO GO 


M 


3 bytes 


2 


Test Data 


00 GG GG 


M 


3 bytes 



B.2.3.14 EFtrac (Transparent Read Access Condition ADM 2) 



MF 



DF TEST 



EF TRAC 



Identifier: '6F0E' 


Structure 


;: transparent 


IVIandatory 


File size: 3 bytes 


1 


Update activity: 


ow 


Access Conditions: 
READ 
UPDATE 
DEACTIVATE 
ACTIVATE 


ADM 2 
ALWAYS 
ALWAYS 
ALWAYS 




Bytes 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


00 GG GG 


M 


3 bytes 



B.2.3.15 EFtdac (Transparent Deactivate Access Condition Application PIN 1) 



MF 



DFTEST 



EF TDAC 



Identifier: '6F0F' 


Structure: transparent | 


Mandatory 


File size: 3 bytes 


1 


Update activity: 


ow 


Access Conditions: 
READ 
UPDATE 
DEACTIVATE 
ACTIVATE 


ALWAYS 

ALWAYS 

Application PIN 1 

ALWAYS 




Bytes 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


00 GG GG 


M 


3 bytes 
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B. 2.3. 16 EFciAc (Cyclic Increase Access Condition ADM 2) 



IVIF 

MF 
1 DFTESl 


r 


_ EFCIAC 
















Identifier: 


'6F10' 




Structure: cyclic | 


Mandatory 


Recorc 


lengtl" 


: 3 bytes 


1 


Update activity: 


ow 






Access Conditions: 
READ 
UPDATE 

INCREASE 
DEACTIVATE 
ACTIVATE 


ALWAYS 
ALWAYS 

ADM 2 
ALWAYS 
ALWAYS 




Logical Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


00 GO GO 


M 


3 bytes 


2 


Test Data 


00 GG GG 


M 


3 bytes 



B.2.3.17 EFciAA (Cyclic Increase Access Condition ADM 1) 

MF 



DF TEST 



EF CIAA 



Identifier: 


'6F11' 




Structure: cyclic | 


Mandatory 


Recorc 


length 


: 3 bytes 


1 


Update activity: 


ow 






Access Conditions: 
READ 
UPDATE 
INCREASE 
DEACTIVATE 
ACTIVATE 


ALWAYS 
ALWAYS 
ADM1 
ALWAYS 
ALWAYS 




Logical Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


00 GG GG 


M 


3 bytes 


2 


Test Data 


00 GG GG 


M 


3 bytes 



B. 2.3. 18 EFcNRA (Cyclic Never Activate) 

MF 



DF TEST 



EFCNAC 



Identifier: '6F1 2' 


Structure 


cyclic Mandatory 


Record length: 3 bytes 


1 


Update activity: low 


Access Conditions: 




READ 




ALWAYS 


UPDATE 




ALWAYS 


INCREASE 




ALWAYS 


DEACTIVATE 




ALWAYS 


ACTIVATE 




NEVER 
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Logical Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


00 00 00 


M 


3 bytes 


2 


Test Data 


00 00 00 


M 


3 bytes 



The Operational state bit of Life Cycle Status Integer shall be DEACTIVATED as defined in TS 102 221 [6]. 

B. 2.3. 19 EFcuAc (Cyclic Update Access Condition Application PIN 1) 



MF 



DF TEST 



EFCUAC 



Identifier: '6F13' 


Structure: cyclic Mandatory 


Record length: 3 bytes 


1 Update activity: high 


Access Conditions: 

READ Application PIN 1 

UPDATE Application PIN 1 

INCREASE Application PIN 1 

DEACTIVATE ADM 1 

ACTIVATE ADM 1 


Logical Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


00 00 00 


M 


3 bytes 


2 


Test Data 


00 00 00 


M 


3 bytes 


3 


Test Data 


00 00 00 


M 


3 bytes 



B.2.3.20 EFtaac (Transparent Activate Access Condition Application PIN 1) 



MF 



DF TEST 



EF TAAC 



Identifier: '6F14' Structure: transparent 


Mandatory 


File size: 3 bytes Update activity: h 


igh 


Access Conditions: 

READ Application PIN 1 
UPDATE ADM 1 
DEACTIVATE ADM 1 

ACTIVATE Application PIN 1 


Bytes 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


FF FF FF 


M 


3 bytes 



B.2.3.21 EFlada (Linear Fixed Activate Deactivate Access Condition ADM 2) 



MF 



DF TEST 



EF LADA 



Identifier: '6F15' 


Structure: linear fixed Mandatory 


Record length: 3 bytes 


Update activity: high 


READ 


Access Conditions: 

Application PIN 1 
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UPDATE 

DEACTIVATE 
ACTIVATE 


Application PIN 1 
ADM 2 
ADM 2 






Logical Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


FF FF FF 


M 


3 bytes 



B. 2.3.22 EFtaaa (Transparent All Access Conditions ADM 1) 

MF 



DETEST 



EF TAAA 



Identifier: '6F1 6' 


Structure 


;: transparent 


Mandatory 


File size: 3 bytes 


1 


Update activity: high 


Access Conditions: 
READ 
UPDATE 
DEACTIVATE 
ACTIVATE 


ADM1 
ADM 1 
ADM1 
ADM1 




Bytes 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


FF FF FF 


M 


3 bytes 



B.2.3.23 EFlrua (Linear Fixed Read Update Access Condition Application 
PIN 1) 



MF 



DF TEST 



EF LRUA 



Identifier: 


'6F17' 


1 


Structure: linear fixed | 


Mandatory 


Record length: 3 bytes 




Update activity: high 






Access Conditions: 
READ 
UPDATE 

DEACTIVATE 

ACTIVATE 


Application PIN 1 
Application PIN 1 

ADM1 

ADM1 




Logical Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


FF FF FF 


M 


3 bytes 



B. 2.3.24 EFlupc (Linear Fixed Update Access Condition ADM 2) 



MF 



DF TEST 



EF LUPC 



Identifier: '6F18' 


Structure: linear fixed Mandatory 


Record length: 10 bytes 


Update activity: high 


READ 


Access Conditions: 

Application PIN 1 
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UPDATE ADM 2 
DEACTIVATE ADM 1 
ACTIVATE ADM 1 


Logical Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


11 ... 11 


M 


10 bytes 


2 


Test Data 


22 ... 22 


M 


10 bytes 



B.2.3.25 EFnosh (Not Shareable) 



MF 



DF TEST 



EF NOSH 



Identifier: '6F1 9' 


Structure 


: transparent 


Mandatory 


File size: 3 bytes 


1 


Update activity: h 


igh 


Access Conditions: 

NOT SHAREABLE 
READ 
UPDATE 
DEACTIVATE 
ACTIVATE 


ALWAYS 
ALWAYS 
ALWAYS 
ALWAYS 




Bytes 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


FF FF FF 


M 


3 bytes 



B.2.3.26 EFlsea (Linear File for SearchRecord tests) 



MF 



DF TEST 



EF LSEA 



Identifier: '6F1 A' Structure: Linear Fixed Mandatory 


Record length: 15 bytes Update activity: high 


Access Conditions: 

READ ALWAYS 
UPDATE ALWAYS 
DEACTIVATE ALWAYS 
ACTIVATE ALWAYS 


Bytes 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


01 02 03 04 05 06 07 08 09 OA 
OBOCODOEOF 


M 


1 5 bytes 


2 


Test Data 


OA OB OC OD OE OF 01 02 03 04 
05 06 07 08 09 


M 


1 5 bytes 


3 


Test Data 


04 05 06 07 08 09 OA OB OC OD 
0E0F01 02 03 


M 


1 5 bytes 


4 


Test Data 


07 08 09 OA OB OC OD OE OF 01 
02 03 04 05 06 


M 


1 5 bytes 


5 


Test Data 


OA 01 02 03 OB 01 02 03 OC 01 
02 03 OD 01 02 


M 


1 5 bytes 


6 


Test Data 


03 02 01 03 02 01 03 02 01 03 
02 01 03 02 01 


M 


1 5 bytes 
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B. 2.3.27 EFcsEA (Cyclic File for SearchRecord tests) 



IVIF 



DF TEST 



EF CSEA 



Identifier: '6F1B' 


Structure: Cyclic 


Mandatory 


Record length: 15 bytes 


1 Update activity: (• 


igh 


1 


Access Conditions: 

READ ALWAYS 
UPDATE ALWAYS 
DEACTIVATE ALWAYS 
ACTIVATE ALWAYS 


Bytes 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


01 02 03 04 05 06 07 08 09 OA 
OBOCODOEOF 


M 


1 5 bytes 


2 


Test Data 


OA OB OC OD OE OF 01 02 03 04 
05 06 07 08 09 


M 


1 5 bytes 


3 


Test Data 


04 05 06 07 08 09 OA OB OC OD 
0E0F01 02 03 


M 


1 5 bytes 


4 


Test Data 


07 08 09 OA OB OC OD OE OF 01 
02 03 04 05 06 


M 


1 5 bytes 


5 


Test Data 


OA 01 02 03 OB 01 02 03 OC 01 
02 03 OD 01 02 


M 


1 5 bytes 


6 


Test Data 


03 02 01 03 02 01 03 02 01 03 
02 01 03 02 01 


M 


1 5 bytes 



B. 2.3.28 EFterm (Terminated) 

MF 



DF TEST 



EFTERM 



Identifier: '6F30' Structure: Transparent Mandatory 


File size: 3 bytes Update activity: low 


LCSI: 
TERMINATED 

Access Conditions: 

READ ALWAYS 
UPDATE ALWAYS 
DEACTIVATE ALWAYS 
ACTIVATE ALWAYS 


Bytes 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


FF FF FF 


M 


3 bytes 
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B. 2.3.29 DFterm (DF Terminated) 

Identifier: '5F30' 

Access Conditions: Record 1 of EFARR (0x2F06 under MP and 0x6F06 under ADFl) 

Life Cycle Status Information: Terminated 

MF 



DFTEST 



DFTERM 



B.2.3.30 EFlarri (Linear Fixed on Access Rule Reference 1) 



MF 



DF TEST 



EF LARR1 



Identifier: '6FA1' Structure: linear fixed Mandatory 


Record length: 3 bytes Update activity: high 


Access Conditions: 
Record 1 of EFarr 


Logical Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


11 11 11 


M 


3 bytes 


2 


Test Data 


22 22 22 


M 


3 bytes 



B.2.3.31 EFlarr2 (Linear Fixed on Access Rule Reference 2) 



MF 



DFTEST 



EF LARR2 



Identifier: '6FA2' Structure: linear fixed Mandatory 


Record length: 3 bytes Update activity: high 


Access Conditions: 
Record 2 of EFarr 


Logical Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


11 11 11 


M 


3 bytes 


2 


Test Data 


22 22 22 


M 


3 bytes 



B.2.3.32 EFlarr3 (Linear Fixed on Access Rule Reference 3) 



MF 



DF TEST 



EF LARR3 



Identifier: '6FA3' 


Structure: linear fixed Mandatory 


Record length: 3 bytes 


1 Update activity: high 


Access Conditions: 
Record 3 of EFarr 
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1 


Logical Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


11 11 11 


M 


3 bytes 


2 


Test Data 


22 22 22 


M 


3 bytes 



B.2.3.33 EFlarr4 (Linear Fixed on Access Rule Reference 4) 



MF 



DF TEST 



EF LARR4 



Identifier: '6FA4' Structure: linear fixed IVIandatory 


Record length: 3 bytes Update activity: high 


Access Conditions: 
Record 4 of EFarr 


Logical Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


11 11 11 


M 


3 bytes 


2 


Test Data 


22 22 22 


M 


3 bytes 



B.2.3.34 EFlarrs (Linear Fixed on Access Rule Reference 5) 



IVIF 



DFTEST 



EF LARR5 



Identifier: '6FA5' Structure: linear fixed 


Mandatory 


Record length: 3 bytes Update activity: h 


ligh 


Access Conditions: 
Record 5 of EFarr 


Logical Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


11 11 11 


M 


3 bytes 


2 


Test Data 


22 22 22 


M 


3 bytes 



B.2.3.35 EFtarri (Transparent on Access Rule Reference 1) 



MF 



DF TEST 



EFTARRI 



Identifier: '6FB1' Structure: transparent Mandatory 


File size: 5 bytes Update activity: high 


Access Conditions: 
Record 1 of EFarr 


Logical Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


11 11 11 11 11 


M 


5 bytes 
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B.2.3.36 EFtarr2 (Transparent on Access Rule Reference 2) 



MF 



DF TEST 



EF TARR2 



Identifier: '6FB2' Structure: transparent 


Mandatory 


File size: 5 bytes Update activity: h 


igh 


Access Conditions: 
Record 2 of EFarr 


Logical Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


11 11 11 11 11 


M 


5 bytes 



B.2.3.37 EFtarrs (Transparent on Access Rule Reference 3) 



MF 



DF TEST 



EF TARR3 



Identifier: '6FB3' Structure: transparent Mandatory 


File size: 5 bytes Update activity: high 


Access Conditions: 
Record 3 of EFarr 


Logical Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


11 11 11 11 11 


M 


5 bytes 



B.2.3.38 EFtarr4 (Transparent on Access Rule Reference 4) 



MF 



DFTEST 



EF TARR4 



Identifier: '6FB4' Structure: transparent Mandatory 


File size: 5 bytes Update activity: high 


Access Conditions: 
Record 4 of EFarr 


Logical Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


11 11 11 11 11 


M 


5 bytes 
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B.2.3.39 EFtarrs (Transparent on Access Rule Reference 5) 



MF 



DF TEST 



EF TARR5 



Identifier: '6FB5' Structure: transparent 


Mandatory 


File size: 5 bytes Update activity: h 


igh 


Access Conditions: 
Record 5 of EFarr 


Logical Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


11 11 11 11 11 


M 


5 bytes 



B.2.3.40 EFcARRi (Cyclic Access Rule Reference 1) 



MF 



DF TEST 



EFCARRI 



Identifier: '6FC1' Structure: cyclic Mandatory 


Record length: 3 bytes Update activity: high 


Access Conditions: 
Record 1 of EFarr 


Logical Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


11 11 11 


M 


3 bytes 


2 


Test Data 


22 22 22 


M 


3 bytes 



B.2.3.41 EFcARR2 (Cyclic Access Rule Reference 2) 



MF 



DFTEST 



EF CARR2 



Identifier: '6FC2' Structure: cyclic Mandatory 


Record length: 3 bytes Update activity: high 


Access Conditions: 
Record 2 of EFarr 


Logical Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


11 11 11 


M 


3 bytes 


2 


Test Data 


22 22 22 


M 


3 bytes 
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B.2.3.42 EFcARRs (Cyclic Access Rule Reference 3) 



MF 



DF TEST 



EF CARR3 



Identifier: '6FC3' Structure: cyclic 


Mandatory 


Record length: 3 bytes Update activity: h 


ligh 


Access Conditions: 
Record 3 of EFarr 


Logical Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


11 11 11 


M 


3 bytes 


2 


Test Data 


22 22 22 


M 


3 bytes 



B.2.3.43 EFcARR4 (Cyclic Access Rule Reference 4) 

MF 



DF TEST 



EF CARR4 



Identifier: '6FC4' Structure: cyclic Mandatory 


Record length: 3 bytes Update activity: high 


Access Conditions: 
Record 4 of EFarr 


Logical Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


11 11 11 


M 


3 bytes 


2 


Test Data 


22 22 22 


M 


3 bytes 



B.2.3.44 EFcARRs (Cyclic Access Rule Reference 5) 



MF 



DFTEST 



EF CARR5 



Identifier: '6FC5' Structure: cyclic Mandatory 


Record length: 3 bytes Update activity: high 


Access Conditions: 
Record 5 of EFarr 


Logical Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


11 11 11 


M 


3 bytes 


2 


Test Data 


22 22 22 


M 


3 bytes 
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B.2.4 DF suB_TEST (Test DF under DF TEST) 



Identifier: '5F10' 
MF 


DF TEST 


DFSUB_ 

EF) 

DFSUB 

r 






EF- 


TEST 


B.2.4.1 

MF 

L 


FAA (Test 

DF TEST 








TEST 









EFTAA 





Identifier: '4F10' Structure: transparent 


Mandatory 




File size: 3 bytes Update activity 


: low 


Access Conditions: 
READ ALWAYS 
UPDATE ALWAYS 
DEACTIVATE ALWAYS 
ACTIVATE ALWAYS 


Bytes 


Description 


Default Value 


M/0 


Length 


1 to 3 


Test Data 


AA AA AA 


M 


3 bytes 



B.2.5 DFarri (DF Access Rule Reference 1) 

Identifier: 'SFll' 

Access Conditions: Record 1 of EFARR (0x2F06 under the MF and 0x6F06 under ADFl). 

MF 



DF TEST 



DFARR1 



B.2.5. 1 EFtarit (Transparent Access Rule 1 Test EF) 



MF 



DF TEST 



DFARR1 



EFTAR1T 





Identifier: '4F11' 


Structure: transparent Mandatory 




File size: 3 bytes 


1 Update activity: low 


Access Conditions: 
Record 1 of EFarr 


Bytes 


Description 


Default Value 


M/0 


Length 


1 to 3 


Test Data 


AA AA AA 


M 


3 bytes 
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B.2.6 DFarr2 (DF Access Rule Reference 2) 

Identifier: '5F12' 

Access Conditions: Record 2 of EFARR (0x2F06 under the MP and 0x6F06 under ADFl). 

MF 



DFTEST 



DFARR2 



B.2.6. 1 EFtar2t (Transparent Access Rule 2 Test EF) 



MF 



DF TEST 



DF ARR2 



EF TAR2T 





Identifier: '4F1 2' 


Structure: transparent 


IVIandatory 




File size: 3 bytes 


1 Update activity: low 


Access Conditions: 
Record 2 of EFarr 


Bytes 


Description 


Default Value 


M/0 


Length 


1 to 3 


Test Data 


AA AA AA 


M 


3 bytes 



B.2.7 DFarrs (DF Access Rule Reference 3) 

Identifier: '5F13' 

Access Conditions: Record 3 of EFARR (0x2F06 under the MF and 0x6F06 under ADFl). 

MF 



DF TEST 



DF ARR3 



B.2.7. 1 EFtarst (Transparent Access Rule 3 Test EF) 



MF 



DF TEST 



DFARRS 



EF TAR3T 





Identifier: '4F1 3' 


Structure: transparent Mandatory 




File size: 3 bytes 


1 Update activity: low 


Access Conditions: 
Record 3 of EFarr 


Bytes 


Description 


Default Value 


M/0 


Length 


1 to 3 


Test Data 


AA AA AA 


M 


3 bytes 
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B.2.8 DFarr4 (DF Access Rule Reference 4) 

Identifier: '5F14' 

Access Conditions: Record 4 of EFARR (0x2F06 under the MP and 0x6F06 under ADFl). 

MF 



DFTEST 



DFARR4 



B.2.8. 1 EFtar4t (Transparent Access Rule 4 Test EF) 



MF 



DF TEST 



DF ARR4 



EF TAR4T 





Identifier: '4F14' 


Structure: transparent 


IVIandatory 




File size: 3 bytes 


1 Update activity: low 


Access Conditions: 
Record 4 of EFarr 


Bytes 


Description 


Default Value 


M/0 


Length 


1 to 3 


Test Data 


AA AA AA 


M 


3 bytes 



B.2.9 DFarrs (DF Access Rule Reference 5) 

Identifier: '5F15' 

Access Conditions: Record 5 of EFARR (0x2F06 under the MF and 0x6F06 under ADFl). 

MF 



DF TEST 



DF ARR5 



B.2.9. 1 EFtarst (Transparent Access Rule 5 Test EF) 



MF 



DF TEST 



DFARRS 



EF TAR5T 





Identifier: '4F15' 


Structure: transparent Mandatory 




File size: 3 bytes 


1 Update activity: low 


Access Conditions: 
Record 5 of EFarr 


Bytes 


Description 


Default Value 


M/0 


Length 


1 to 3 


Test Data 


AA AA AA 


M 


3 bytes 
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B.3 First application dedicated files system ADF1 

The prepersonalization of UlCC cards shall contain ADFl. 

Figure B.2 shows the additional prepersonalization, the file system and files' content under ADFl system. 

All the files are defined as in the UICC file system server. 



B.3.1 DFjELECOM 



Identifier: 7F10' 
ADF1 



DFTELECOIVI 



B. 3.4.1 EFsuME(EFSetUpMenu) 

ADFl 



OF TELECOM 



EFSUIVIE 



Identifier: '6F54' Structure: transparent IVIandatory 


File size: 1 7 bytes Update activity: low 


Access Conditions: 
READ ALWAYS 
UPDATE ALWAYS 
DEACTIVATE ALWAYS 
ACTIVATE ALWAYS 


Bytes 


Description 


Default Value 


M/0 


Length 


1 to 17 


Test Data 


85 09 55 49 43 43 20 54 45 53 54 FF FF 
FF FF FF FF 


M 


17 bytes 



B.3.4.2 EFarr (UICC Test Access Rules EF) 



MF 



EFARR 



Identifier: '6F06' Structure: Linear fixed | Optional 


SFI : none 




Record length : n bytes 


Update activity: low 


Access Conditions: 
READ ALWAYS 
UPDATE ALWAYS 
DEACTIVATE ALWAYS 
ACTIVATE ALWAYS 


Bytes 


Description 


Default Value 


M/0 


Length 


1 ton 


Access Rule 1 


Always for all commands 


M 


n bytes 


n+1 to 2n 


Access Rule 2 


Never for all commands 


M 


n bytes 


2n+1 to 3n 


Access Rule 3 


Global PIN1 & ADM1 for all commands 


M 


n bytes 


3n+1 to 4n 


Access Rule 4 


Global PIN1 1 ADM1 for all commands 


M 


n bytes 


4n+1 to 5n 


Access Rule 5 


Local PIN1 for all commands 


M 


n bytes 
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Access rules definition: 



Record 
nb 


Delete selft 


Terminat 

card 

Usage/ 

Terminate 

DF 


Activate 
File 


Deactivate 
File 


Create File 

(DF 
creation) 


Create File 

(EF 
creation) 


Delete File 
(child) 




Delete File 


Terminate 
EF 


Activate 
File 


Deactivate 
File 


Write 
Binary, 

Write 
Record, 
Append 
Record 


Update 
Binary, 
Update 
Record, 
Erase 
Binary 


Read 
binary. 

Read 
Record, 
Search 
Binary, 
Search 
Record 


Increase, 
resize 


1 


Always 


Always 


Always 


Always 


Always 


Always 


Always 


Always 


2 


Never 


Never 


Never 


Never 


Never 


Never 


Never 


Never 


3 


Global PIN1 
&ADM1 


Global PIN1 
&ADM1 


Global PIN1 
&ADM1 


Global PIN1 
&ADM1 


Global PIN1 
&ADM1 


Global PIN1 
&ADM1 


Global PIN1 
&ADM1 


Global PIN1 
&ADM1 


4 


Global PIN1 
1 ADM1 


Global PIN1 
1 ADM1 


Global PIN1 
1 ADM1 


Global PIN1 
1 ADM1 


Global PIN1 
1 ADM1 


Global PIN1 
1 ADM1 


Global PIN1 
1 ADM1 


Global PIN1 
1 ADM1 


5 


Local PIN1 


Local PIN1 


Local PIN1 


Local PIN1 


Local PIN1 


Local PIN1 


Local PIN1 


Local PIN1 



B.4 Second application dedicated files system ADF2 

The prepersonalization of UICC cards shall contain ADF2. 

Figure B.3 shows the additional prepersonalization, the file system and files' content under ADF2 system. 



B.4.1 EFuicc (UICC Test EF) 



ADF2 



EFUICC 





Identifier: '2FE4' Structure: transparent 


IVIandatory 




File size: 3 bytes 1 Update activity 


: low 


Access Conditions: 
READ ALWAYS 
UPDATE ALWAYS 
DEACTIVATE ALWAYS 
ACTIVATE ALWAYS 


Bytes 


Description 


Default Value 


M/0 


Length 


1 to 3 


Test Data 


CC CC CC 


M 


3 bytes 



B.4.2 DFjEST (1 St Test DF under ADF2) 



Identifier: 7F4A' 
ADF2 



DF TEST 
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B.4.2.1 DFsuB.TEST (1 DF under DF_TEST) 

Identifier: '5F10' 



ADF2 



DF TEST 



DF SUB TEST 



B.4.2.1.1EFTAA(TestEF) 





Identifier: '4F10' Structure: transparent 


IVlandatory 




File size: 3 bytes 1 Update activity 


: low 


Access Conditions: 
READ ALWAYS 
UPDATE ALWAYS 
DEACTIVATE ALWAYS 
ACTIVATE ALWAYS 


Bytes 


Description 


Default Value 


M/0 


Length 


1 to 3 


Test Data 


AA AA AA 


M 


3 bytes 



ADF2 



DFTEST 



DF SUB TEST 



EFTAA 



»nd 



B.4.3 DFadf2 (2"° Test DF under ADF2) 



Identifier: 7F4B' 
ADF2 



DF ADF2 
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Annex C (normative): 
Test file description 



Every test source is written in javaT"^ and shall use methods defined in Annex D interfaces to communicate with the 
card, or to check status word or received data. 

In order to be more readable, data specified as method string parameters shall be presented in 4 blocks of 4 bytes per 
line. Every block is separated by a space character. Every string line is appended to previous one and shall be aligned. 
An example is provided in Annex D. 

Every test file shall start with a call to reset() method. 

Except otherwise stated, each reset() method shall be followed by a profile download. 
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Annex D (normative): 

uicc.test.util package, Uicc interfaces and testing script 

example 

See attached files: 

• Annex_D_UiccTestUtil.zip 

• Annex_D_UiccInterfaces.zip 

• Annex_D_Example.zip 
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Annex E (normative): 
Test Area files 

See attached file: 

• Annex_E_SourceCode.zip 
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Annex F (informative): 
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Change history 


Date 


SCP# 


TSG Doc 


CR 


Rev 


Cat 


Subject/Comment 


Old 


New 


2005-12 


23 


SCP- 
050425 








Draft presented at SCP Plenary #23 




1.0.0 


2007-01 


29 


SCP- 
070014 








Presented for approval 


1.0.0 


2.0.0 


2007-01 


29 


SCP- 
070014 








Editorial corrections 


2.0.0 


2.0.1 


2007-01 


29 










Rise to Rel-6 


2.0.1 


6.0.0 











































































































































































































































































































ETSI 



Release 6 



770 



ETSI TS 102 268 V6.0.0 (2007-03) 



History 



Document history 


V6.0.0 


March 2007 


Publication 



























ETSI 



